@copado/agentia-cli 0.38.0-alpha.0 → 0.41.0-alpha.0

package/dist/lib/setup-prompts.d.ts

@@ -0,0 +1,30 @@
+export type ConfirmPromptOptions = {
+    default?: boolean;
+    message: string;
+};
+export type InputPromptOptions = {
+    default?: string;
+    message: string;
+    validate?: (value: string) => boolean | string;
+};
+export type PasswordPromptOptions = {
+    message: string;
+    validate?: (value: string) => boolean | string;
+};
+export type SelectChoice<T> = {
+    name: string;
+    value: T;
+};
+export type SelectPromptOptions<T> = {
+    choices: Array<SelectChoice<T>>;
+    default?: T;
+    message: string;
+};
+export type SetupPrompts = {
+    confirm: (options: ConfirmPromptOptions) => Promise<boolean>;
+    input: (options: InputPromptOptions) => Promise<string>;
+    password: (options: PasswordPromptOptions) => Promise<string>;
+    select: <T>(options: SelectPromptOptions<T>) => Promise<T>;
+};
+export declare function isPromptCanceled(error: unknown): boolean;
+export declare function createInquirerSetupPrompts(): SetupPrompts;

package/dist/lib/setup-prompts.js

@@ -0,0 +1,13 @@
+import { confirm, input, password, select } from '@inquirer/prompts';
+export function isPromptCanceled(error) {
+    return typeof error === 'object' && error !== null && error.name === 'ExitPromptError';
+}
+export function createInquirerSetupPrompts() {
+    return {
+        confirm: (options) => confirm(options),
+        input: (options) => input(options),
+        password: (options) => password({ ...options, mask: true }),
+        select: (options) => select(options),
+    };
+}
+//# sourceMappingURL=setup-prompts.js.map

package/dist/lib/setup-prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-prompts.js","sourceRoot":"","sources":["../../src/lib/setup-prompts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAC,MAAM,mBAAmB,CAAA;AAoClE,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAK,KAAyB,CAAC,IAAI,KAAK,iBAAiB,CAAA;AAC7G,CAAC;AAED,MAAM,UAAU,0BAA0B;IACxC,OAAO;QACL,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;QACtC,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC;QAClC,QAAQ,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAC,GAAG,OAAO,EAAE,IAAI,EAAE,IAAI,EAAC,CAAC;QACzD,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC;KACrC,CAAA;AACH,CAAC"}

package/dist/lib/setup-templates.d.ts

@@ -4,8 +4,8 @@
  */
 export declare const DEFAULT_AGENTS_MD_URL = "";
 export declare const AGENTIA_GITIGNORE_ENTRY = ".agentia/";
-export declare const SAMPLE_QUALITY_GATES_UNIX = "#!/usr/bin/env bash\nset -euo pipefail\n\n# Local Agentia quality gates (macOS / Linux).\n# Edit this script to match your project. Agentia runs it from the repo root during\n# `agentia work test --local` and `agentia work submit` (unless --skip-local-tests).\n# The script must exit non-zero if any check fails.\n\nsf code-analyzer run\nsf force lightning lwc test run\n";
-export declare const SAMPLE_QUALITY_GATES_WINDOWS = "@echo off\nsetlocal EnableExtensions\nREM Local Agentia quality gates (Windows).\nREM Edit this script to match your project. Agentia runs it from the repo root during\nREM `agentia work test --local` and `agentia work submit` (unless --skip-local-tests).\nREM The script must exit non-zero if any check fails.\n\nsf code-analyzer run\nif errorlevel 1 exit /b %errorlevel%\nsf force lightning lwc test run\nif errorlevel 1 exit /b %errorlevel%\n";
+export declare const SAMPLE_QUALITY_GATES_UNIX = "#!/usr/bin/env bash\nset -euo pipefail\n\n# Local Agentia quality gates (macOS / Linux).\n# Edit this script to match your project. Agentia runs it from the repo root during\n# `agentia cicd work test --local` and `agentia cicd work submit` (unless --skip-local-tests).\n# The script must exit non-zero if any check fails.\n\necho \"## Running Code Analyzer\"\nsf code-analyzer run\n\nif [[ -n \"${AGENTIA_APEX_TEST_CLASSES:-}\" ]]; then\n  # Normalize commas to spaces so --class-names gets discrete values\n  # shellcheck disable=SC2206\n  class_names=(${AGENTIA_APEX_TEST_CLASSES//,/ })\n  if [[ ${#class_names[@]} -gt 0 ]]; then\n    echo \"## Running Apex tests: ${class_names[@]}\"\n    sf apex run test --class-names \"${class_names[@]}\" --result-format human --wait 10\n  fi\nfi\n\necho \"## Running LWC tests\"\nnpx sfdx-lwc-jest -- # --passWithNoTests\n";
+export declare const SAMPLE_QUALITY_GATES_WINDOWS = "@echo off\nsetlocal EnableExtensions EnableDelayedExpansion\nREM Local Agentia quality gates (Windows).\nREM Edit this script to match your project. Agentia runs it from the repo root during\nREM `agentia cicd work test --local` and `agentia cicd work submit` (unless --skip-local-tests).\nREM The script must exit non-zero if any check fails.\n\necho ## Running Code Analyzer\nsf code-analyzer run\nif errorlevel 1 exit /b %errorlevel%\n\nif defined AGENTIA_APEX_TEST_CLASSES (\n  set \"CLASS_NAMES=!AGENTIA_APEX_TEST_CLASSES:,= !\"\n  if not \"!CLASS_NAMES!\"==\"\" (\n    echo ## Running Apex tests: !CLASS_NAMES!\n    sf apex run test --class-names !CLASS_NAMES! --result-format human --wait 10\n    if errorlevel 1 exit /b %errorlevel%\n  )\n)\n\necho ## Running LWC tests\nnpx sfdx-lwc-jest --\nif errorlevel 1 exit /b %errorlevel%\n";
 /** Bundled AGENTS.md template (mirrors docs/AGENTS.sample.md). Used when DEFAULT_AGENTS_MD_URL is unset or download fails. */
-export declare const BUNDLED_AGENTS_MD = "# Agentia CLI for AI Agents\n\nUse Agentia to manage Copado user stories end-to-end: pick work, prepare a git branch, push changes, submit for review, and promote.\n\n**Prefer the Agentia MCP server when it is available.** If tools such as `agentia_work_list`, `agentia_work_set`, `agentia_work_push`, `agentia_work_submit`, and `agentia_work_done` are registered, call those instead of shelling out to the `agentia` CLI. Fall back to CLI commands only when MCP is not configured.\n\nWhen using the CLI, prefer `--json` on every command so you can parse structured output instead of terminal tables.\n\nAuthentication must already be configured (`agentia auth set` / keychain, or local gateway mode). Run from a git repository that is a Copado-managed project.\n\n## Typical workflow\n\n```text\nlist \u2192 get \u2192 set \u2192 (implement & commit) \u2192 push \u2192 submit \u2192 done\n```\n\n| Step | MCP tool (preferred) | CLI fallback | Purpose |\n| --- | --- | --- | --- |\n| 1 | `agentia_work_list` (`assignedToMe: true`) | `agentia work list --assigned-to-me --json` | Show user stories assigned to you |\n| 2 | `agentia_work_get` | `agentia work get [id] --json` | Read user story details (omit id after `work set`) |\n| 3 | `agentia_work_set` | `agentia work set <id> --json` | Mark in progress and prepare the feature branch |\n| 4 | *(your edits + `git commit`)* | *(your edits + `git commit`)* | Implement the story |\n| 5 | `agentia_work_push` | `agentia work push --json` | Push commits to git and register them with Copado |\n| 6 | `agentia_work_submit` | `agentia work submit --json` | Flag ready for review (pipeline quality gates / validation) |\n| 7 | `agentia_work_done` | `agentia work done --json` | Promote and deploy to the next stage |\n\nDo not skip `work set` before coding. Later steps expect a `feature/<user-story-name>` branch and a recorded base branch from `work set`.\n\n---\n\n## Commands\n\nCLI examples below are the fallback when MCP is unavailable. MCP tool names and arguments mirror these commands (camelCase args instead of flags).\n\n### `agentia work list`\n\nShow user stories. For \u201Cassigned to me\u201D, always use:\n\n```sh\nagentia work list --assigned-to-me --json\n```\n\nUseful filters: `--status`, `--project-name`, `--name`, `--owned-by-me`. Do not combine `--assigned-to-me` with `--owned-by-me` or `--assignee-id`.\n\n### `agentia work get [id]`\n\nRead full details for one user story. After `work set`, omit the ID to use the active work item:\n\n```sh\nagentia work get --json\nagentia work get a0SKC000000CmZ2AU --json\n```\n\nUse this before starting work to understand title, status, acceptance criteria, and related fields.\n\n### `agentia work set <id>`\n\nFlag the user story as the active work item (in progress) and prepare the correct git branch:\n\n```sh\nagentia work set a0SKC000000CmZ2AU --json\n# or by name:\nagentia work set US-0001 --json\n```\n\nWhat it does:\n\n1. Calls Copado to set the work item and resolve the base branch\n2. Requires a **clean tracked working tree** (stash or commit first if dirty)\n3. Fetches `origin/<base-branch>`\n4. Creates or checks out `feature/<user-story-name>`\n5. Records the last work item ID, name, and base branch for later commands\n\nOptional: `--base-branch <name>` overrides the base branch from the API.\n\nAfter success, stay on that feature branch for all implementation commits.\n\n### `agentia work push`\n\nPush committed changes to git and register them with Copado:\n\n```sh\nagentia work push --json\n```\n\nPrerequisites:\n\n- Current branch is `feature/US-XXXX` (from `work set`)\n- No uncommitted tracked changes (commit first)\n- `work set` was run so a base branch is recorded\n\nLocks the tip commit, runs `git push origin <branch>`, then registers the commits with Copado.\n\n### `agentia work test --local`\n\nRun local project quality gates without submitting:\n\n```sh\nagentia work test --local --json\n```\n\nIf the project root contains `.agentia_quality_gates.sh` (macOS/Linux) or `.agentia_quality_gates.cmd` (Windows), that script runs and the command stops on failure. Only `--local` is supported for now.\n\n### `agentia work submit`\n\nFlag the user story as ready for review. Runs local project quality gates (when present), then pipeline quality gates and validation:\n\n```sh\nagentia work submit --json\nagentia work submit --skip-local-tests --json\n```\n\nSame branch/clean-tree rules as `work push`. If the project root contains `.agentia_quality_gates.sh` (macOS/Linux) or `.agentia_quality_gates.cmd` (Windows), that script runs first and submit stops on failure (same local gates as `work test --local`). Use `--skip-local-tests` to skip it. If the branch has unpushed commits, it pushes and registers them next, then submits.\n\n### `agentia work done`\n\nPromote and deploy the user story to the next pipeline stage:\n\n```sh\nagentia work done --json\n```\n\nSame branch/clean-tree rules as `work submit`. Pushes unpushed commits if needed, then promotes (without the validate-only path used by submit).\n\nOnly run this when the story is approved and ready to move to the next environment.\n\n---\n\n## Agent rules\n\n1. **Prefer MCP over CLI.** When Agentia MCP tools are available, use them instead of running `agentia` in the shell.\n2. **Discover before acting.** List assigned stories, then `get` the chosen ID, then `set` before editing files.\n3. **One story, one feature branch.** Do not mix unrelated commits on the same `feature/US-XXXX` branch.\n4. **Commit yourself; push with Agentia.** Use normal `git add` / `git commit` for local commits. Use `agentia_work_push` / `agentia work push` (not bare `git push`) so Copado receives the commit registration.\n5. **Keep the tree clean** before `set`, `push`, `submit`, and `done`. Those steps fail if tracked changes are pending.\n6. **Prefer structured results.** MCP returns JSON; for CLI, use `--json` and do not scrape human table output.\n7. **Order matters.** `set` \u2192 commit \u2192 `push` \u2192 `submit` \u2192 `done`. `submit` and `done` will auto-push if the branch is ahead of origin, but `set` is still required first.\n8. **Confirm intent for `done`.** Promotion deploys to the next stage; do not run it unless the user asked to promote/deploy.\n";
+export declare const BUNDLED_AGENTS_MD = "# Agentia CLI for AI Agents\n\nUse Agentia to manage Copado user stories end-to-end: pick work, prepare a git branch, push changes, submit for review, and promote.\n\n**Prefer the Agentia MCP server when it is available.** If tools such as `agentia_work_list`, `agentia_work_set`, `agentia_work_push`, `agentia_work_submit`, and `agentia_work_done` are registered, call those instead of shelling out to the `agentia` CLI. Fall back to CLI commands only when MCP is not configured.\n\nWhen using the CLI, prefer `--json` on every command so you can parse structured output instead of terminal tables.\n\nAuthentication must already be configured (`agentia auth set` / keychain, or local gateway mode). Run from a git repository that is a Copado-managed project.\n\n## Typical workflow\n\n```text\nlist \u2192 get \u2192 set \u2192 (implement & commit) \u2192 push \u2192 submit \u2192 done\n```\n\n| Step | MCP tool (preferred) | CLI fallback | Purpose |\n| --- | --- | --- | --- |\n| 1 | `agentia_work_list` (`assignedToMe: true`) | `agentia cicd work list --assigned-to-me --json` | Show user stories assigned to you |\n| 2 | `agentia_work_get` | `agentia cicd work get [id] --json` | Read user story details (omit id after `work set`) |\n| 3 | `agentia_work_set` | `agentia cicd work set <id> --json` | Mark in progress and prepare the feature branch |\n| 4 | *(your edits + `git commit`)* | *(your edits + `git commit`)* | Implement the story |\n| 5 | `agentia_work_push` | `agentia cicd work push --json` | Push commits to git and register them with Copado |\n| 6 | `agentia_work_submit` | `agentia cicd work submit --json` | Flag ready for review (pipeline quality gates / validation) |\n| 7 | `agentia_work_done` | `agentia cicd work done --json` | Promote and deploy to the next stage |\n\nDo not skip `work set` before coding. Later steps expect a `feature/<user-story-name>` branch and a recorded base branch from `work set`.\n\n---\n\n## Commands\n\nCLI examples below are the fallback when MCP is unavailable. MCP tool names and arguments mirror these commands (camelCase args instead of flags).\n\n### `agentia cicd work list`\n\nShow user stories. For \u201Cassigned to me\u201D, always use:\n\n```sh\nagentia cicd work list --assigned-to-me --json\n```\n\nUseful filters: `--status`, `--project-name`, `--name`, `--owned-by-me`. Do not combine `--assigned-to-me` with `--owned-by-me` or `--assignee-id`.\n\n### `agentia cicd work get [id]`\n\nRead full details for one user story. After `work set`, omit the ID to use the active work item:\n\n```sh\nagentia cicd work get --json\nagentia cicd work get a0SKC000000CmZ2AU --json\n```\n\nUse this before starting work to understand title, status, acceptance criteria, and related fields.\n\n### `agentia cicd work set <id>`\n\nFlag the user story as the active work item (in progress) and prepare the correct git branch:\n\n```sh\nagentia cicd work set a0SKC000000CmZ2AU --json\n# or by name:\nagentia cicd work set US-0001 --json\n```\n\nWhat it does:\n\n1. Calls Copado to set the work item and resolve the base branch\n2. Requires a **clean tracked working tree** (stash or commit first if dirty)\n3. Fetches `origin/<base-branch>`\n4. Creates or checks out `feature/<user-story-name>`\n5. Records the last work item ID, name, and base branch for later commands\n\nOptional: `--base-branch <name>` overrides the base branch from the API.\n\nAfter success, stay on that feature branch for all implementation commits.\n\n### `agentia cicd work push`\n\nPush committed changes to git and register them with Copado:\n\n```sh\nagentia cicd work push --json\n```\n\nPrerequisites:\n\n- Current branch is `feature/US-XXXX` (from `work set`)\n- No uncommitted tracked changes (commit first)\n- `work set` was run so a base branch is recorded\n\nLocks the tip commit, runs `git push origin <branch>`, then registers the commits with Copado.\n\n### `agentia cicd work test --local`\n\nRun local project quality gates without submitting:\n\n```sh\nagentia cicd work test --local --json\nagentia cicd work test --local --apex-test-classes=MyTest,OtherTest --json\n```\n\nIf the project root contains `.agentia_quality_gates.sh` (macOS/Linux) or `.agentia_quality_gates.cmd` (Windows), that script runs and the command stops on failure. Only `--local` is supported for now. Optional `--apex-test-classes=class1,class2` is passed to the script as `AGENTIA_APEX_TEST_CLASSES` (MCP: `apexTestClasses`).\n\n### `agentia cicd work submit`\n\nFlag the user story as ready for review. Runs local project quality gates (when present), then pipeline quality gates and validation:\n\n```sh\nagentia cicd work submit --json\nagentia cicd work submit --apex-test-classes=MyTest,OtherTest --json\nagentia cicd work submit --skip-local-tests --json\n```\n\nSame branch/clean-tree rules as `work push`. If the project root contains `.agentia_quality_gates.sh` (macOS/Linux) or `.agentia_quality_gates.cmd` (Windows), that script runs first and submit stops on failure (same local gates as `work test --local`). Use `--apex-test-classes=class1,class2` to pass Apex test classes to the script as `AGENTIA_APEX_TEST_CLASSES` (MCP: `apexTestClasses`). Use `--skip-local-tests` to skip local gates. If the branch has unpushed commits, it pushes and registers them next, then submits.\n\n### `agentia cicd work done`\n\nPromote and deploy the user story to the next pipeline stage:\n\n```sh\nagentia cicd work done --json\n```\n\nSame branch/clean-tree rules as `work submit`. Pushes unpushed commits if needed, then promotes (without the validate-only path used by submit).\n\nOnly run this when the story is approved and ready to move to the next environment.\n\n---\n\n## Agent rules\n\n1. **Prefer MCP over CLI.** When Agentia MCP tools are available, use them instead of running `agentia` in the shell.\n2. **Discover before acting.** List assigned stories, then `get` the chosen ID, then `set` before editing files.\n3. **One story, one feature branch.** Do not mix unrelated commits on the same `feature/US-XXXX` branch.\n4. **Commit yourself; push with Agentia.** Use normal `git add` / `git commit` for local commits. Use `agentia_work_push` / `agentia cicd work push` (not bare `git push`) so Copado receives the commit registration.\n5. **Keep the tree clean** before `set`, `push`, `submit`, and `done`. Those steps fail if tracked changes are pending.\n6. **Prefer structured results.** MCP returns JSON; for CLI, use `--json` and do not scrape human table output.\n7. **Order matters.** `set` \u2192 commit \u2192 `push` \u2192 `submit` \u2192 `done`. `submit` and `done` will auto-push if the branch is ahead of origin, but `set` is still required first.\n8. **Confirm intent for `done`.** Promotion deploys to the next stage; do not run it unless the user asked to promote/deploy.\n";
 export declare function qualityGatesExplanation(bin?: string): string;

package/dist/lib/setup-templates.js

@@ -10,22 +10,47 @@ set -euo pipefail
 
 # Local Agentia quality gates (macOS / Linux).
 # Edit this script to match your project. Agentia runs it from the repo root during
-# \`agentia work test --local\` and \`agentia work submit\` (unless --skip-local-tests).
+# \`agentia cicd work test --local\` and \`agentia cicd work submit\` (unless --skip-local-tests).
 # The script must exit non-zero if any check fails.
 
+echo "## Running Code Analyzer"
 sf code-analyzer run
-sf force lightning lwc test run
+
+if [[ -n "\${AGENTIA_APEX_TEST_CLASSES:-}" ]]; then
+  # Normalize commas to spaces so --class-names gets discrete values
+  # shellcheck disable=SC2206
+  class_names=(\${AGENTIA_APEX_TEST_CLASSES//,/ })
+  if [[ \${#class_names[@]} -gt 0 ]]; then
+    echo "## Running Apex tests: \${class_names[@]}"
+    sf apex run test --class-names "\${class_names[@]}" --result-format human --wait 10
+  fi
+fi
+
+echo "## Running LWC tests"
+npx sfdx-lwc-jest -- # --passWithNoTests
 `;
 export const SAMPLE_QUALITY_GATES_WINDOWS = `@echo off
-setlocal EnableExtensions
+setlocal EnableExtensions EnableDelayedExpansion
 REM Local Agentia quality gates (Windows).
 REM Edit this script to match your project. Agentia runs it from the repo root during
-REM \`agentia work test --local\` and \`agentia work submit\` (unless --skip-local-tests).
+REM \`agentia cicd work test --local\` and \`agentia cicd work submit\` (unless --skip-local-tests).
 REM The script must exit non-zero if any check fails.
 
+echo ## Running Code Analyzer
 sf code-analyzer run
 if errorlevel 1 exit /b %errorlevel%
-sf force lightning lwc test run
+
+if defined AGENTIA_APEX_TEST_CLASSES (
+  set "CLASS_NAMES=!AGENTIA_APEX_TEST_CLASSES:,= !"
+  if not "!CLASS_NAMES!"=="" (
+    echo ## Running Apex tests: !CLASS_NAMES!
+    sf apex run test --class-names !CLASS_NAMES! --result-format human --wait 10
+    if errorlevel 1 exit /b %errorlevel%
+  )
+)
+
+echo ## Running LWC tests
+npx sfdx-lwc-jest --
 if errorlevel 1 exit /b %errorlevel%
 `;
 /** Bundled AGENTS.md template (mirrors docs/AGENTS.sample.md). Used when DEFAULT_AGENTS_MD_URL is unset or download fails. */
@@ -47,13 +72,13 @@ list → get → set → (implement & commit) → push → submit → done
 
 | Step | MCP tool (preferred) | CLI fallback | Purpose |
 | --- | --- | --- | --- |
-| 1 | \`agentia_work_list\` (\`assignedToMe: true\`) | \`agentia work list --assigned-to-me --json\` | Show user stories assigned to you |
-| 2 | \`agentia_work_get\` | \`agentia work get [id] --json\` | Read user story details (omit id after \`work set\`) |
-| 3 | \`agentia_work_set\` | \`agentia work set <id> --json\` | Mark in progress and prepare the feature branch |
+| 1 | \`agentia_work_list\` (\`assignedToMe: true\`) | \`agentia cicd work list --assigned-to-me --json\` | Show user stories assigned to you |
+| 2 | \`agentia_work_get\` | \`agentia cicd work get [id] --json\` | Read user story details (omit id after \`work set\`) |
+| 3 | \`agentia_work_set\` | \`agentia cicd work set <id> --json\` | Mark in progress and prepare the feature branch |
 | 4 | *(your edits + \`git commit\`)* | *(your edits + \`git commit\`)* | Implement the story |
-| 5 | \`agentia_work_push\` | \`agentia work push --json\` | Push commits to git and register them with Copado |
-| 6 | \`agentia_work_submit\` | \`agentia work submit --json\` | Flag ready for review (pipeline quality gates / validation) |
-| 7 | \`agentia_work_done\` | \`agentia work done --json\` | Promote and deploy to the next stage |
+| 5 | \`agentia_work_push\` | \`agentia cicd work push --json\` | Push commits to git and register them with Copado |
+| 6 | \`agentia_work_submit\` | \`agentia cicd work submit --json\` | Flag ready for review (pipeline quality gates / validation) |
+| 7 | \`agentia_work_done\` | \`agentia cicd work done --json\` | Promote and deploy to the next stage |
 
 Do not skip \`work set\` before coding. Later steps expect a \`feature/<user-story-name>\` branch and a recorded base branch from \`work set\`.
 
@@ -63,35 +88,35 @@ Do not skip \`work set\` before coding. Later steps expect a \`feature/<user-sto
 
 CLI examples below are the fallback when MCP is unavailable. MCP tool names and arguments mirror these commands (camelCase args instead of flags).
 
-### \`agentia work list\`
+### \`agentia cicd work list\`
 
 Show user stories. For “assigned to me”, always use:
 
 \`\`\`sh
-agentia work list --assigned-to-me --json
+agentia cicd work list --assigned-to-me --json
 \`\`\`
 
 Useful filters: \`--status\`, \`--project-name\`, \`--name\`, \`--owned-by-me\`. Do not combine \`--assigned-to-me\` with \`--owned-by-me\` or \`--assignee-id\`.
 
-### \`agentia work get [id]\`
+### \`agentia cicd work get [id]\`
 
 Read full details for one user story. After \`work set\`, omit the ID to use the active work item:
 
 \`\`\`sh
-agentia work get --json
-agentia work get a0SKC000000CmZ2AU --json
+agentia cicd work get --json
+agentia cicd work get a0SKC000000CmZ2AU --json
 \`\`\`
 
 Use this before starting work to understand title, status, acceptance criteria, and related fields.
 
-### \`agentia work set <id>\`
+### \`agentia cicd work set <id>\`
 
 Flag the user story as the active work item (in progress) and prepare the correct git branch:
 
 \`\`\`sh
-agentia work set a0SKC000000CmZ2AU --json
+agentia cicd work set a0SKC000000CmZ2AU --json
 # or by name:
-agentia work set US-0001 --json
+agentia cicd work set US-0001 --json
 \`\`\`
 
 What it does:
@@ -106,12 +131,12 @@ Optional: \`--base-branch <name>\` overrides the base branch from the API.
 
 After success, stay on that feature branch for all implementation commits.
 
-### \`agentia work push\`
+### \`agentia cicd work push\`
 
 Push committed changes to git and register them with Copado:
 
 \`\`\`sh
-agentia work push --json
+agentia cicd work push --json
 \`\`\`
 
 Prerequisites:
@@ -122,33 +147,35 @@ Prerequisites:
 
 Locks the tip commit, runs \`git push origin <branch>\`, then registers the commits with Copado.
 
-### \`agentia work test --local\`
+### \`agentia cicd work test --local\`
 
 Run local project quality gates without submitting:
 
 \`\`\`sh
-agentia work test --local --json
+agentia cicd work test --local --json
+agentia cicd work test --local --apex-test-classes=MyTest,OtherTest --json
 \`\`\`
 
-If the project root contains \`${QUALITY_GATES_SCRIPT_UNIX}\` (macOS/Linux) or \`${QUALITY_GATES_SCRIPT_WINDOWS}\` (Windows), that script runs and the command stops on failure. Only \`--local\` is supported for now.
+If the project root contains \`${QUALITY_GATES_SCRIPT_UNIX}\` (macOS/Linux) or \`${QUALITY_GATES_SCRIPT_WINDOWS}\` (Windows), that script runs and the command stops on failure. Only \`--local\` is supported for now. Optional \`--apex-test-classes=class1,class2\` is passed to the script as \`AGENTIA_APEX_TEST_CLASSES\` (MCP: \`apexTestClasses\`).
 
-### \`agentia work submit\`
+### \`agentia cicd work submit\`
 
 Flag the user story as ready for review. Runs local project quality gates (when present), then pipeline quality gates and validation:
 
 \`\`\`sh
-agentia work submit --json
-agentia work submit --skip-local-tests --json
+agentia cicd work submit --json
+agentia cicd work submit --apex-test-classes=MyTest,OtherTest --json
+agentia cicd work submit --skip-local-tests --json
 \`\`\`
 
-Same branch/clean-tree rules as \`work push\`. If the project root contains \`${QUALITY_GATES_SCRIPT_UNIX}\` (macOS/Linux) or \`${QUALITY_GATES_SCRIPT_WINDOWS}\` (Windows), that script runs first and submit stops on failure (same local gates as \`work test --local\`). Use \`--skip-local-tests\` to skip it. If the branch has unpushed commits, it pushes and registers them next, then submits.
+Same branch/clean-tree rules as \`work push\`. If the project root contains \`${QUALITY_GATES_SCRIPT_UNIX}\` (macOS/Linux) or \`${QUALITY_GATES_SCRIPT_WINDOWS}\` (Windows), that script runs first and submit stops on failure (same local gates as \`work test --local\`). Use \`--apex-test-classes=class1,class2\` to pass Apex test classes to the script as \`AGENTIA_APEX_TEST_CLASSES\` (MCP: \`apexTestClasses\`). Use \`--skip-local-tests\` to skip local gates. If the branch has unpushed commits, it pushes and registers them next, then submits.
 
-### \`agentia work done\`
+### \`agentia cicd work done\`
 
 Promote and deploy the user story to the next pipeline stage:
 
 \`\`\`sh
-agentia work done --json
+agentia cicd work done --json
 \`\`\`
 
 Same branch/clean-tree rules as \`work submit\`. Pushes unpushed commits if needed, then promotes (without the validate-only path used by submit).
@@ -162,7 +189,7 @@ Only run this when the story is approved and ready to move to the next environme
 1. **Prefer MCP over CLI.** When Agentia MCP tools are available, use them instead of running \`agentia\` in the shell.
 2. **Discover before acting.** List assigned stories, then \`get\` the chosen ID, then \`set\` before editing files.
 3. **One story, one feature branch.** Do not mix unrelated commits on the same \`feature/US-XXXX\` branch.
-4. **Commit yourself; push with Agentia.** Use normal \`git add\` / \`git commit\` for local commits. Use \`agentia_work_push\` / \`agentia work push\` (not bare \`git push\`) so Copado receives the commit registration.
+4. **Commit yourself; push with Agentia.** Use normal \`git add\` / \`git commit\` for local commits. Use \`agentia_work_push\` / \`agentia cicd work push\` (not bare \`git push\`) so Copado receives the commit registration.
 5. **Keep the tree clean** before \`set\`, \`push\`, \`submit\`, and \`done\`. Those steps fail if tracked changes are pending.
 6. **Prefer structured results.** MCP returns JSON; for CLI, use \`--json\` and do not scrape human table output.
 7. **Order matters.** \`set\` → commit → \`push\` → \`submit\` → \`done\`. \`submit\` and \`done\` will auto-push if the branch is ahead of origin, but \`set\` is still required first.

package/dist/lib/setup-templates.js.map

@@ -1 +1 @@
-{"version":3,"file":"setup-templates.js","sourceRoot":"","sources":["../../src/lib/setup-templates.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,4BAA4B,GAC7B,MAAM,0BAA0B,CAAA;AAEjC;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAA;AAEvC,MAAM,CAAC,MAAM,uBAAuB,GAAG,WAAW,CAAA;AAElD,MAAM,CAAC,MAAM,yBAAyB,GAAG;;;;;;;;;;CAUxC,CAAA;AAED,MAAM,CAAC,MAAM,4BAA4B,GAAG;;;;;;;;;;;CAW3C,CAAA;AAED,8HAA8H;AAC9H,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCAqGA,yBAAyB,yBAAyB,4BAA4B;;;;;;;;;;;gFAW/B,yBAAyB,yBAAyB,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;CA0B7J,CAAA;AAED,MAAM,UAAU,uBAAuB,CAAC,GAAG,GAAG,SAAS;IACrD,OAAO;QACL,sBAAsB;QACtB,OAAO,yBAAyB,yBAAyB,4BAA4B,cAAc;QACnG,OAAO,GAAG,0BAA0B,GAAG,uEAAuE;QAC9G,WAAW,GAAG,qEAAqE;QACnF,mFAAmF;QACnF,8GAA8G;KAC/G,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC"}
+{"version":3,"file":"setup-templates.js","sourceRoot":"","sources":["../../src/lib/setup-templates.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,4BAA4B,GAC7B,MAAM,0BAA0B,CAAA;AAEjC;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAA;AAEvC,MAAM,CAAC,MAAM,uBAAuB,GAAG,WAAW,CAAA;AAElD,MAAM,CAAC,MAAM,yBAAyB,GAAG;;;;;;;;;;;;;;;;;;;;;;;CAuBxC,CAAA;AAED,MAAM,CAAC,MAAM,4BAA4B,GAAG;;;;;;;;;;;;;;;;;;;;;;;CAuB3C,CAAA;AAED,8HAA8H;AAC9H,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCAsGA,yBAAyB,yBAAyB,4BAA4B;;;;;;;;;;;;gFAY/B,yBAAyB,yBAAyB,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;CA0B7J,CAAA;AAED,MAAM,UAAU,uBAAuB,CAAC,GAAG,GAAG,SAAS;IACrD,OAAO;QACL,sBAAsB;QACtB,OAAO,yBAAyB,yBAAyB,4BAA4B,cAAc;QACnG,OAAO,GAAG,0BAA0B,GAAG,uEAAuE;QAC9G,WAAW,GAAG,qEAAqE;QACnF,mFAAmF;QACnF,8GAA8G;KAC/G,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC"}

package/dist/lib/setup-wizard.d.ts

@@ -0,0 +1,42 @@
+import { applyAuthSet, getCicdAuthStatus, getCrtAuthStatus } from './auth-config.js';
+import { type CursorMcpStatus, detectCursorInstall, getCursorMcpStatus, upsertAgentiaCursorMcp } from './cursor-mcp-config.js';
+import { type ProjectAssetSetupResult, type SetupActionStatus, type SetupDeps, type SetupOptions } from './project-setup.js';
+export type SetupWizardAuthResult = {
+    baseUrl?: string;
+    configured: boolean;
+    domain?: string;
+    orgId?: string;
+    status: SetupActionStatus;
+};
+export type SetupWizardCursorResult = {
+    detected: boolean;
+    global: CursorMcpStatus & {
+        status: SetupActionStatus;
+    };
+    local: CursorMcpStatus & {
+        status: SetupActionStatus;
+    };
+};
+export type SetupResult = ProjectAssetSetupResult & {
+    auth: {
+        cicd: SetupWizardAuthResult;
+        crt: SetupWizardAuthResult;
+    };
+    cursorMcp: SetupWizardCursorResult;
+    nextSteps: string[];
+};
+export type SetupWizardOptions = SetupOptions & {
+    withSpinner?: <T>(message: string, action: () => Promise<T>) => Promise<T>;
+};
+export type SetupWizardDeps = SetupDeps & {
+    applyAuthSet?: typeof applyAuthSet;
+    detectCursorInstall?: typeof detectCursorInstall;
+    getCicdAuthStatus?: typeof getCicdAuthStatus;
+    getCrtAuthStatus?: typeof getCrtAuthStatus;
+    getCursorMcpStatus?: typeof getCursorMcpStatus;
+    homedir?: () => string;
+    upsertAgentiaCursorMcp?: typeof upsertAgentiaCursorMcp;
+};
+export declare function setSetupWizardDepsForTests(deps: SetupWizardDeps | undefined): void;
+export declare function resetSetupWizardDepsForTests(): void;
+export declare function runSetupWizard(options?: SetupWizardOptions, deps?: SetupWizardDeps): Promise<SetupResult>;