jiradc-cli 1.0.29 → 1.0.31

package/README.md

@@ -119,52 +119,52 @@ Search and list commands accept `--limit` to control page size (Jira DC caps at
 
 ```bash
 # Get an issue with default fields
-jiradc issue get AI-123
+jiradc issue get PROJ-123
 
 # Get an issue with specific fields
-jiradc issue get AI-123 --fields summary,status,assignee,customfield_10100
+jiradc issue get PROJ-123 --fields summary,status,assignee,customfield_10100
 
 # Search with JQL
 jiradc issue search 'project = AI AND status = "In Development" ORDER BY updated DESC'
 
 # Create an issue
-jiradc issue create --project AI --type Task --summary "Implement feature X" --description "Details here"
+jiradc issue create --project PROJ --type Task --summary "Implement feature X" --description "Details here"
 
 # Create with custom fields
-jiradc issue create --project AI --type Story --summary "User login" --custom-fields '{"customfield_10100": "value"}'
+jiradc issue create --project PROJ --type Story --summary "User login" --custom-fields '{"customfield_10100": "value"}'
 
 # Transition by ID or by status name
-jiradc issue transitions AI-123
-jiradc issue transition AI-123 --to 31
-jiradc issue transition AI-123 --to "In Review" --comment "Ready for review"
+jiradc issue transitions PROJ-123
+jiradc issue transition PROJ-123 --to 31
+jiradc issue transition PROJ-123 --to "In Review" --comment "Ready for review"
 
 # Assign
-jiradc issue assign AI-123 me
-jiradc issue assign AI-123 jsmith
-jiradc issue assign AI-123 none
+jiradc issue assign PROJ-123 me
+jiradc issue assign PROJ-123 jsmith
+jiradc issue assign PROJ-123 none
 
 # Update with shortcuts (instead of --fields JSON)
-jiradc issue update AI-123 --summary "New title" --priority High
-jiradc issue update AI-123 --assignee me
-jiradc issue update AI-123 --labels backend,urgent           # set mode
-jiradc issue update AI-123 --labels +urgent,-backend          # mutate mode
-jiradc issue update AI-123 --components +Frontend
-jiradc issue update AI-123 --fix-versions 1.0,2.0
+jiradc issue update PROJ-123 --summary "New title" --priority High
+jiradc issue update PROJ-123 --assignee me
+jiradc issue update PROJ-123 --labels backend,urgent           # set mode
+jiradc issue update PROJ-123 --labels +urgent,-backend          # mutate mode
+jiradc issue update PROJ-123 --components +Frontend
+jiradc issue update PROJ-123 --fix-versions 1.0,2.0
 
 # Link multiple issues to an epic in one call
-jiradc issue link-epic AI-456 AI-457 AI-458 --epic AI-100
+jiradc issue link-epic PROJ-456 PROJ-457 PROJ-458 --epic PROJ-100
 
 # Add a comment
-jiradc issue comment add AI-123 --body "Fixed in commit abc123"
+jiradc issue comment add PROJ-123 --body "Fixed in commit abc123"
 
 # Delete a comment
-jiradc issue comment delete AI-123 --id 12345
+jiradc issue comment delete PROJ-123 --id 12345
 
 # Link two issues
-jiradc issue link AI-123 AI-456 --type "blocks"
+jiradc issue link PROJ-123 PROJ-456 --type "blocks"
 
 # Log work
-jiradc issue worklog add AI-123 --time "2h 30m" --comment "Code review"
+jiradc issue worklog add PROJ-123 --time "2h 30m" --comment "Code review"
 
 # List active sprints
 jiradc sprint list 42 --state active
@@ -176,11 +176,11 @@ jiradc sprint issues 42 100
 jiradc field search --query "story points"
 
 # Clone an issue with subtasks
-jiradc issue clone AI-123
+jiradc issue clone PROJ-123
 
 # Get dev status (linked branches, PRs)
-jiradc issue dev-status AI-123
+jiradc issue dev-status PROJ-123
 
 # List components for a project
-jiradc component list --project AI
+jiradc component list --project PROJ
 ```

package/dist/index.js

@@ -237,6 +237,24 @@ var CliAuthError = class extends Error {
     this.name = "CliAuthError";
   }
 };
+var NOT_FOUND_RECOVERY = "Verify the id/key, then check your access.";
+var NOT_FOUND_MESSAGE = "Not found: it may not exist, or you may not have permission to see it";
+var CliNotFoundError = class extends Error {
+  recovery;
+  constructor(message, recovery = NOT_FOUND_RECOVERY) {
+    super(message);
+    this.name = "CliNotFoundError";
+    this.recovery = recovery;
+  }
+};
+var SubcommandRequiredError = class extends Error {
+  subcommands;
+  constructor(commandPath3, subcommands) {
+    super(`'${commandPath3}' requires a subcommand`);
+    this.name = "SubcommandRequiredError";
+    this.subcommands = subcommands;
+  }
+};
 var TYPE_EXIT = {
   usage: EXIT.USAGE,
   not_found: EXIT.NOT_FOUND,
@@ -285,9 +303,21 @@ function normalize(err, opts) {
       retryable: false
     };
   }
+  if (err instanceof SubcommandRequiredError) {
+    return {
+      type: "usage",
+      message,
+      recovery: `Re-run with one of these subcommands: ${err.subcommands.join(", ")}.`,
+      retryable: false,
+      detail: { subcommands: err.subcommands }
+    };
+  }
   if (err instanceof CliAuthError) {
     return { type: "auth", message: message || "Missing credentials", recovery: opts.authRecovery, retryable: false };
   }
+  if (err instanceof CliNotFoundError) {
+    return { type: "not_found", message, recovery: err.recovery, retryable: false };
+  }
   const status = httpStatus(err);
   const detail = responseDetail(err);
   if (status !== void 0) {
@@ -296,7 +326,7 @@ function normalize(err, opts) {
         return {
           type: "usage",
           status,
-          message: "Bad request (HTTP 400)",
+          message: "Bad request",
           recovery: "Check parameter values (ids, keys, query syntax) against the API.",
           retryable: false,
           detail
@@ -305,7 +335,7 @@ function normalize(err, opts) {
         return {
           type: "auth",
           status,
-          message: "Authentication failed (HTTP 401)",
+          message: "Authentication failed",
           recovery: opts.authRecovery,
           retryable: false
         };
@@ -313,7 +343,7 @@ function normalize(err, opts) {
         return {
           type: "forbidden",
           status,
-          message: "Forbidden (HTTP 403)",
+          message: "Forbidden",
           recovery: `Your ${opts.service} account lacks permission for this operation; check token scope and resource permissions.`,
           retryable: false,
           detail
@@ -322,8 +352,8 @@ function normalize(err, opts) {
         return {
           type: "not_found",
           status,
-          message: "Not found (HTTP 404)",
-          recovery: "Verify the id/key exists and that you have access to it.",
+          message: NOT_FOUND_MESSAGE,
+          recovery: NOT_FOUND_RECOVERY,
           retryable: false,
           detail
         };
@@ -331,7 +361,7 @@ function normalize(err, opts) {
         return {
           type: "conflict",
           status,
-          message: "Conflict (HTTP 409)",
+          message: "Conflict",
           recovery: "The resource changed or already exists; re-fetch current state and retry.",
           retryable: false,
           detail
@@ -340,7 +370,7 @@ function normalize(err, opts) {
         return {
           type: "rate_limited",
           status,
-          message: "Rate limited (HTTP 429)",
+          message: "Rate limited",
           recovery: "Wait and retry the request.",
           retryable: true
         };
@@ -410,8 +440,30 @@ function routeErrors(cmd) {
   cmd.configureOutput({ writeErr: () => void 0 });
   cmd.commands.forEach(routeErrors);
 }
+function commandPath2(cmd) {
+  const parts = [];
+  let cur = cmd;
+  while (cur) {
+    parts.unshift(cur.name());
+    cur = cur.parent;
+  }
+  return parts.join(" ");
+}
+function attachSubcommandGuards(cmd) {
+  cmd.commands.forEach(attachSubcommandGuards);
+  if (cmd.commands.length === 0)
+    return;
+  const hasAction = Boolean(cmd._actionHandler);
+  if (hasAction)
+    return;
+  cmd.action(() => {
+    const names = cmd.commands.map((c) => c.name()).filter((name) => name !== "help");
+    throw new SubcommandRequiredError(commandPath2(cmd), names);
+  });
+}
 async function runCli(program, opts) {
   routeErrors(program);
+  attachSubcommandGuards(program);
   try {
     await program.parseAsync();
   } catch (err) {
@@ -962,9 +1014,9 @@ function create(parent) {
   const cmd = parent.command("create").description("Create a new component in a project").requiredOption("--project <key>", "Project key (e.g., AI)", text).requiredOption("--name <name>", "Component name", text).option("--lead <username>", "Username of the component lead", text).addOption(new Option3("--assignee-type <type>", "Assignee strategy").choices(ASSIGNEE_TYPES));
   textOrFileOption(cmd, "description", { description: "Component description" });
   examples(cmd, [
-    "--project AI --name Backend",
-    '--project AI --name Frontend --description "UI work" --lead jsmith',
-    "--project AI --name Infra --assignee-type COMPONENT_LEAD --lead jsmith"
+    "--project PROJ --name Backend",
+    '--project PROJ --name Frontend --description "UI work" --lead jsmith',
+    "--project PROJ --name Infra --assignee-type COMPONENT_LEAD --lead jsmith"
   ]);
   cmd.action(
     async (opts) => {
@@ -1018,7 +1070,7 @@ function issueCount(parent) {
 // src/commands/component/list.ts
 function list2(parent) {
   const cmd = parent.command("list").description("List all components for a project").requiredOption("--project <key>", "Project key (e.g., AI)", text);
-  examples(cmd, ["--project AI"]);
+  examples(cmd, ["--project PROJ"]);
   cmd.action(async (opts) => {
     const client = getClient();
     const result = await client.components.list({ projectKeyOrId: opts.project });
@@ -1065,9 +1117,9 @@ function update(parent) {
 function registerComponentCommands(program) {
   const component = program.command("component").description("Project component operations");
   examples(component, [
-    "list --project AI",
+    "list --project PROJ",
     "get 11289",
-    "create --project AI --name Backend",
+    "create --project PROJ --name Backend",
     "update 11289 --name Backend",
     "delete 11289 --move-issues-to 11290",
     "issue-count 11289"
@@ -1737,7 +1789,7 @@ function link(parent) {
   const cmd = parent.command("link").description("Link two issues together").requiredOption("--type <name>", "Link type name (e.g., 'Blocks', 'Duplicate', 'Relates')", text).requiredOption("--from <key>", 'Source issue key (e.g., the issue that "blocks")', issueKey).requiredOption("--to <key>", 'Target issue key (e.g., the issue that "is blocked by")', issueKey);
   commentOption(cmd, { description: "Optional comment" });
   examples(cmd, [
-    "--type Relates --from AI-154 --to AI-149",
+    "--type Relates --from PROJ-154 --to PROJ-149",
     ["--type Blocks --from PROJ-456 --to PROJ-123", "PROJ-456 blocks PROJ-123"]
   ]);
   cmd.action(async (opts) => {
@@ -2397,14 +2449,50 @@ function registerUserCommands(program) {
   search3(user);
 }
 
+// src/utils/xray/guards.ts
+function assertExactlyOne(opts, keys, label) {
+  const present = keys.filter((k) => opts[k] !== void 0);
+  if (present.length !== 1)
+    throw new Error(`Provide exactly one of ${keys.map((k) => `--${k}`).join(", ")} (${label}).`);
+  return present[0];
+}
+function assertAtLeastOne(opts, keys) {
+  if (!keys.some((k) => opts[k] !== void 0))
+    throw new Error(`Provide at least one of ${keys.map((k) => `--${k}`).join(", ")}.`);
+}
+
 // src/commands/xray/execution/add.ts
 function add(parent) {
-  const cmd = parent.command("add").description("Add tests to a Test Execution").argument("<execKey>", "Test Execution issue key (e.g. AI-200)", issueKey).requiredOption("--test <keys>", "Comma-separated test issue keys to add (e.g. AI-1,AI-2)", keyList);
-  examples(cmd, ["AI-200 --test AI-1", "AI-200 --test AI-1,AI-2,AI-3"]);
+  const cmd = parent.command("add").description("Add tests to a Test Execution, directly (--test) and/or by expanding Test Sets (--set)").argument("<execKey>", "Test Execution issue key (e.g. PROJ-200)", issueKey).option("--test <keys>", "Comma-separated test issue keys to add (e.g. PROJ-1,PROJ-2)", keyList).option(
+    "--set <keys>",
+    "Comma-separated Test Set keys; each set's current tests are added to the execution (e.g. PROJ-300)",
+    keyList
+  );
+  examples(cmd, [
+    "PROJ-200 --test PROJ-1",
+    "PROJ-200 --test PROJ-1,PROJ-2",
+    "PROJ-200 --set PROJ-300",
+    "PROJ-200 --test PROJ-1 --set PROJ-300"
+  ]);
   cmd.action(async (execKey, opts) => {
-    const client = getClient();
-    const result = await client.testExecutions.addTests({ execKey, keys: opts.test });
-    output(result ?? { added: true });
+    assertAtLeastOne(opts, ["test", "set"]);
+    const client = getClient();
+    const keys = new Set(opts.test ?? []);
+    if (opts.set) {
+      const lists = await Promise.all(opts.set.map((setKey) => client.testSets.listTests({ setKey })));
+      for (const list20 of lists) {
+        const tests = Array.isArray(list20) ? list20 : list20.tests ?? [];
+        for (const t of tests) {
+          if (t.key) keys.add(String(t.key));
+        }
+      }
+    }
+    const allKeys = [...keys];
+    if (allKeys.length === 0) {
+      throw new Error("No tests to add \u2014 the given --set(s) contain no tests and no --test keys were provided.");
+    }
+    const result = await client.testExecutions.addTests({ execKey, keys: allKeys });
+    output(result ?? { added: allKeys });
   });
 }
 
@@ -2441,8 +2529,8 @@ function create7(parent) {
   const cmd = parent.command("create").description("Create a new Xray Test Execution issue").requiredOption("--project <key>", "Project key (e.g. AI)", text).requiredOption("--summary <text>", "Test Execution summary (title)", text);
   textOrFileOption(cmd, "description", { description: "Test Execution description" });
   examples(cmd, [
-    '--project AI --summary "Sprint 42 regression run"',
-    '--project AI --summary "Smoke run" --description "Post-deploy smoke"'
+    '--project PROJ --summary "Sprint 42 regression run"',
+    '--project PROJ --summary "Smoke run" --description "Post-deploy smoke"'
   ]);
   cmd.action(async (opts) => {
     const description = resolveTextOrFile(opts, "description", { required: false });
@@ -2459,8 +2547,8 @@ function create7(parent) {
 
 // src/commands/xray/execution/delete.ts
 function deleteExecution(parent) {
-  const cmd = parent.command("delete").description("Delete an Xray Test Execution issue").argument("<execKey>", "Test Execution issue key (e.g. AI-200)", issueKey);
-  examples(cmd, ["AI-200"]);
+  const cmd = parent.command("delete").description("Delete an Xray Test Execution issue").argument("<execKey>", "Test Execution issue key (e.g. PROJ-200)", issueKey);
+  examples(cmd, ["PROJ-200"]);
   cmd.action(async (execKey) => {
     const client = getClient();
     await deleteXrayIssue(client, execKey);
@@ -2472,8 +2560,8 @@ function deleteExecution(parent) {
 function list8(parent) {
   const cmd = parent.command("list").description(
     "List Test Executions that contain a given test (inverse view). For the tests inside an execution, use: xray test list --execution <key>."
-  ).requiredOption("--test <key>", "Test issue key whose executions to list (e.g. AI-584)", issueKey);
-  examples(cmd, ["--test AI-584"]);
+  ).requiredOption("--test <key>", "Test issue key whose executions to list (e.g. PROJ-584)", issueKey);
+  examples(cmd, ["--test PROJ-584"]);
   cmd.action(async (opts) => {
     const client = getClient();
     const executions = await client.xrayTests.getTestExecutions({ testKey: opts.test });
@@ -2483,8 +2571,8 @@ function list8(parent) {
 
 // src/commands/xray/execution/remove.ts
 function remove(parent) {
-  const cmd = parent.command("remove").description("Remove tests from a Test Execution").argument("<execKey>", "Test Execution issue key (e.g. AI-200)", issueKey).requiredOption("--test <keys>", "Comma-separated test issue keys to remove (e.g. AI-1,AI-2)", keyList);
-  examples(cmd, ["AI-200 --test AI-1", "AI-200 --test AI-1,AI-2"]);
+  const cmd = parent.command("remove").description("Remove tests from a Test Execution").argument("<execKey>", "Test Execution issue key (e.g. PROJ-200)", issueKey).requiredOption("--test <keys>", "Comma-separated test issue keys to remove (e.g. PROJ-1,PROJ-2)", keyList);
+  examples(cmd, ["PROJ-200 --test PROJ-1", "PROJ-200 --test PROJ-1,PROJ-2"]);
   cmd.action(async (execKey, opts) => {
     const client = getClient();
     const result = await client.testExecutions.removeTests({ execKey, keys: opts.test });
@@ -2494,9 +2582,9 @@ function remove(parent) {
 
 // src/commands/xray/execution/update.ts
 function update6(parent) {
-  const cmd = parent.command("update").description("Update an Xray Test Execution issue").argument("<execKey>", "Test Execution issue key (e.g. AI-200)", issueKey).option("--summary <text>", "New summary (title)", text);
+  const cmd = parent.command("update").description("Update an Xray Test Execution issue").argument("<execKey>", "Test Execution issue key (e.g. PROJ-200)", issueKey).option("--summary <text>", "New summary (title)", text);
   textOrFileOption(cmd, "description", { description: "New Test Execution description" });
-  examples(cmd, ['AI-200 --summary "Updated execution title"', 'AI-200 --description "Post-hotfix run"']);
+  examples(cmd, ['PROJ-200 --summary "Updated execution title"', 'PROJ-200 --description "Post-hotfix run"']);
   cmd.action(async (execKey, opts) => {
     const description = resolveTextOrFile(opts, "description", { required: false });
     const client = getClient();
@@ -2511,9 +2599,9 @@ function registerExecutionCommands(xray) {
     "Xray Test Execution issue management (CRUD, membership). To list tests inside an execution, use: xray test list --execution <key>."
   );
   examples(execution2, [
-    'create --project AI --summary "Sprint 42 regression run"',
-    "add AI-200 --test AI-1,AI-2",
-    "list --test AI-584"
+    'create --project PROJ --summary "Sprint 42 regression run"',
+    "add PROJ-200 --test PROJ-1,PROJ-2",
+    "list --test PROJ-584"
   ]);
   create7(execution2);
   update6(execution2);
@@ -2528,7 +2616,7 @@ import { writeFileSync as writeFileSync2 } from "fs";
 import { basename, join as join5 } from "path";
 function feature(parent) {
   const cmd = parent.command("feature").description("Export Gherkin .feature files for the given test keys").requiredOption("--test <keys>", "Comma-separated Test, Set, Plan, or Execution issue keys", keyList).option("--output <path>", "Write the exported file to this path (default: ./<filename> from response)", text).option("--zip", "Request a zip archive instead of a single .feature file");
-  examples(cmd, ["--test AI-584 --output ai-584.feature"]);
+  examples(cmd, ["--test PROJ-584 --output ai-584.feature"]);
   cmd.action(async (opts) => {
     const client = getClient();
     const { data, filename } = await client.xrayExport.exportFeature({
@@ -2566,8 +2654,8 @@ function registerFieldCommands2(xray) {
 
 // src/commands/xray/folder/add.ts
 function add2(parent) {
-  const cmd = parent.command("add").description("Add tests to a folder in the test repository").argument("<folderId>", "Folder id (from folder list)", positiveInt).requiredOption("--project <key>", "Project key (e.g. QA)", text).requiredOption("--test <keys>", "Comma-separated test issue keys to add (e.g. QA-1,QA-2)", keyList);
-  examples(cmd, ["818 --project QA --test QA-1", "818 --project QA --test QA-1,QA-2,QA-3"]);
+  const cmd = parent.command("add").description("Add tests to a folder in the test repository").argument("<folderId>", "Folder id (from folder list)", positiveInt).requiredOption("--project <key>", "Project key (e.g. QA)", text).requiredOption("--test <keys>", "Comma-separated test issue keys to add (e.g. PROJ-1,PROJ-2)", keyList);
+  examples(cmd, ["818 --project PROJ --test PROJ-1", "818 --project PROJ --test PROJ-1,PROJ-2,PROJ-3"]);
   cmd.action(async (folderId, opts) => {
     const client = getClient();
     const result = await client.testRepository.updateFolderTests({
@@ -2583,9 +2671,9 @@ function add2(parent) {
 function create8(parent) {
   const cmd = parent.command("create").description("Create a new folder in the test repository").requiredOption("--project <key>", "Project key (e.g. QA)", text).option("--parent-id <id>", "Parent folder id (-1 = root)", integer, -1).requiredOption("--name <text>", "Folder name", text);
   examples(cmd, [
-    "--project QA --name Smoke",
-    '--project QA --parent-id -1 --name "Regression Suite"',
-    '--project AI --parent-id 818 --name "Sub-folder"'
+    "--project PROJ --name Smoke",
+    '--project PROJ --parent-id -1 --name "Regression Suite"',
+    '--project PROJ --parent-id 818 --name "Sub-folder"'
   ]);
   cmd.action(async (opts) => {
     const client = getClient();
@@ -2601,7 +2689,7 @@ function create8(parent) {
 // src/commands/xray/folder/delete.ts
 function deleteFolder(parent) {
   const cmd = parent.command("delete").description("Delete a folder from the test repository").argument("<folderId>", "Folder id to delete (from folder list)", positiveInt).requiredOption("--project <key>", "Project key (e.g. QA)", text);
-  examples(cmd, ["818 --project QA", "42 --project AI"]);
+  examples(cmd, ["818 --project PROJ", "42 --project PROJ"]);
   cmd.action(async (folderId, opts) => {
     const client = getClient();
     await client.testRepository.deleteFolder({ projectKey: opts.project, folderId });
@@ -2612,7 +2700,7 @@ function deleteFolder(parent) {
 // src/commands/xray/folder/list.ts
 function list10(parent) {
   const cmd = parent.command("list").description("List the test repository folder tree for a project").requiredOption("--project <key>", "Project key (e.g. QA)", text);
-  examples(cmd, ["--project QA", "--project AI"]);
+  examples(cmd, ["--project PROJ", "--project PROJ"]);
   cmd.action(async (opts) => {
     const client = getClient();
     const tree = await client.testRepository.getFolders({ projectKey: opts.project });
@@ -2622,8 +2710,8 @@ function list10(parent) {
 
 // src/commands/xray/folder/remove.ts
 function remove2(parent) {
-  const cmd = parent.command("remove").description("Remove tests from a folder in the test repository").argument("<folderId>", "Folder id (from folder list)", positiveInt).requiredOption("--project <key>", "Project key (e.g. QA)", text).requiredOption("--test <keys>", "Comma-separated test issue keys to remove (e.g. QA-1,QA-2)", keyList);
-  examples(cmd, ["818 --project QA --test QA-1", "818 --project QA --test QA-1,QA-2"]);
+  const cmd = parent.command("remove").description("Remove tests from a folder in the test repository").argument("<folderId>", "Folder id (from folder list)", positiveInt).requiredOption("--project <key>", "Project key (e.g. QA)", text).requiredOption("--test <keys>", "Comma-separated test issue keys to remove (e.g. PROJ-1,PROJ-2)", keyList);
+  examples(cmd, ["818 --project PROJ --test PROJ-1", "818 --project PROJ --test PROJ-1,PROJ-2"]);
   cmd.action(async (folderId, opts) => {
     const client = getClient();
     const result = await client.testRepository.updateFolderTests({
@@ -2639,9 +2727,9 @@ function remove2(parent) {
 function update7(parent) {
   const cmd = parent.command("update").description("Rename or reorder a folder in the test repository").argument("<folderId>", "Folder id (from folder list)", positiveInt).requiredOption("--project <key>", "Project key (e.g. QA)", text).option("--name <text>", "New folder name", text).option("--rank <id>", "New folder rank/position", positiveInt);
   examples(cmd, [
-    '818 --project QA --name "New Name"',
-    "818 --project QA --rank 2",
-    "818 --project AI --name Smoke --rank 1"
+    '818 --project PROJ --name "New Name"',
+    "818 --project PROJ --rank 2",
+    "818 --project PROJ --name Smoke --rank 1"
   ]);
   cmd.action(async (folderId, opts) => {
     if (opts.name === void 0 && opts.rank === void 0) {
@@ -2663,7 +2751,7 @@ function registerFolderCommands(xray) {
   const folder = xray.command("folder").description(
     "Xray Test Repository folder management (rename/reorder within parent only \u2014 cross-parent moves are UI-only, not supported by the API). To list tests in a folder use: xray test list --folder <id> --project <key>"
   );
-  examples(folder, ["list --project QA", "create --project QA --parent-id -1 --name Smoke"]);
+  examples(folder, ["list --project PROJ", "create --project PROJ --parent-id -1 --name Smoke"]);
   list10(folder);
   create8(folder);
   update7(folder);
@@ -2694,8 +2782,8 @@ function execution(parent) {
     issueKey
   ).option("--plan <key>", "Associate with a Test Plan issue key", issueKey).option("--fix-version <text>", "Fix version to set on the Test Execution", text).option("--revision <text>", "Source control revision", text).option("--environments <text>", "Comma-separated test environment names", text);
   examples(cmd, [
-    "--file results.xml --format junit --project AI",
-    "--file results.xml --format junit --execution AI-100",
+    "--file results.xml --format junit --project PROJ",
+    "--file results.xml --format junit --execution PROJ-100",
     "--file results.json --format xray"
   ]);
   cmd.action(
@@ -2730,7 +2818,7 @@ import { readFileSync as readFileSync5 } from "fs";
 import { basename as basename3 } from "path";
 function feature2(parent) {
   const cmd = parent.command("feature").description("Import a Gherkin .feature file into the Xray test repository (multipart)").requiredOption("--file <path>", "Path to the .feature file", filePath).requiredOption("--project <text>", "Project key to import the feature into", text);
-  examples(cmd, ["--file login.feature --project AI"]);
+  examples(cmd, ["--file login.feature --project PROJ"]);
   cmd.action(async (opts) => {
     const fileBuffer = readFileSync5(opts.file);
     const filename = basename3(opts.file);
@@ -2751,22 +2839,14 @@ function registerImportCommands(xray) {
   feature2(importGroup);
 }
 
-// src/utils/xray/guards.ts
-function assertExactlyOne(opts, keys, label) {
-  const present = keys.filter((k) => opts[k] !== void 0);
-  if (present.length !== 1)
-    throw new Error(`Provide exactly one of ${keys.map((k) => `--${k}`).join(", ")} (${label}).`);
-  return present[0];
-}
-function assertAtLeastOne(opts, keys) {
-  if (!keys.some((k) => opts[k] !== void 0))
-    throw new Error(`Provide at least one of ${keys.map((k) => `--${k}`).join(", ")}.`);
-}
-
 // src/commands/xray/plan/add.ts
 function add3(parent) {
-  const cmd = parent.command("add").description("Add tests and/or executions to a Test Plan").argument("<planKey>", "Test Plan issue key (e.g. QA-573)", issueKey).option("--test <keys>", "Comma-separated test issue keys to add (e.g. QA-1,QA-2)", keyList).option("--execution <keys>", "Comma-separated test execution keys to add (e.g. QA-200,QA-201)", keyList);
-  examples(cmd, ["QA-573 --test QA-1,QA-2", "QA-573 --execution QA-200", "QA-573 --test QA-1 --execution QA-200"]);
+  const cmd = parent.command("add").description("Add tests and/or executions to a Test Plan").argument("<planKey>", "Test Plan issue key (e.g. PROJ-573)", issueKey).option("--test <keys>", "Comma-separated test issue keys to add (e.g. PROJ-1,PROJ-2)", keyList).option("--execution <keys>", "Comma-separated test execution keys to add (e.g. PROJ-200,PROJ-201)", keyList);
+  examples(cmd, [
+    "PROJ-573 --test PROJ-1,PROJ-2",
+    "PROJ-573 --execution PROJ-200",
+    "PROJ-573 --test PROJ-1 --execution PROJ-200"
+  ]);
   cmd.action(async (planKey, opts) => {
     assertAtLeastOne(opts, ["test", "execution"]);
     const client = getClient();
@@ -2783,8 +2863,8 @@ function create9(parent) {
   const cmd = parent.command("create").description("Create a new Xray Test Plan issue").requiredOption("--project <key>", "Project key (e.g. QA)", text).requiredOption("--summary <text>", "Test Plan summary (title)", text);
   textOrFileOption(cmd, "description", { description: "Test Plan description" });
   examples(cmd, [
-    '--project QA --summary "Q3 regression plan"',
-    '--project QA --summary "Sprint 42 plan" --description "Covers all sprint stories"'
+    '--project PROJ --summary "Q3 regression plan"',
+    '--project PROJ --summary "Sprint 42 plan" --description "Covers all sprint stories"'
   ]);
   cmd.action(async (opts) => {
     const description = resolveTextOrFile(opts, "description", { required: false });
@@ -2801,8 +2881,8 @@ function create9(parent) {
 
 // src/commands/xray/plan/delete.ts
 function deletePlan(parent) {
-  const cmd = parent.command("delete").description("Delete an Xray Test Plan issue").argument("<planKey>", "Test Plan issue key (e.g. QA-573)", issueKey);
-  examples(cmd, ["QA-573"]);
+  const cmd = parent.command("delete").description("Delete an Xray Test Plan issue").argument("<planKey>", "Test Plan issue key (e.g. PROJ-573)", issueKey);
+  examples(cmd, ["PROJ-573"]);
   cmd.action(async (planKey) => {
     const client = getClient();
     await deleteXrayIssue(client, planKey);
@@ -2814,8 +2894,8 @@ function deletePlan(parent) {
 function list11(parent) {
   const cmd = parent.command("list").description(
     "List Test Plans that contain a given test (inverse view). For the tests inside a plan, use: xray test list --plan <key>. For executions in a plan, use: xray execution list --plan <key>."
-  ).requiredOption("--test <key>", "Test issue key whose plans to list (e.g. QA-574)", issueKey);
-  examples(cmd, ["--test QA-574"]);
+  ).requiredOption("--test <key>", "Test issue key whose plans to list (e.g. PROJ-574)", issueKey);
+  examples(cmd, ["--test PROJ-574"]);
   cmd.action(async (opts) => {
     const client = getClient();
     const plans = await client.xrayTests.getTestPlans({ testKey: opts.test });
@@ -2825,8 +2905,12 @@ function list11(parent) {
 
 // src/commands/xray/plan/remove.ts
 function remove3(parent) {
-  const cmd = parent.command("remove").description("Remove tests and/or executions from a Test Plan").argument("<planKey>", "Test Plan issue key (e.g. QA-573)", issueKey).option("--test <keys>", "Comma-separated test issue keys to remove (e.g. QA-1,QA-2)", keyList).option("--execution <keys>", "Comma-separated test execution keys to remove (e.g. QA-200)", keyList);
-  examples(cmd, ["QA-573 --test QA-1", "QA-573 --execution QA-200", "QA-573 --test QA-1 --execution QA-200"]);
+  const cmd = parent.command("remove").description("Remove tests and/or executions from a Test Plan").argument("<planKey>", "Test Plan issue key (e.g. PROJ-573)", issueKey).option("--test <keys>", "Comma-separated test issue keys to remove (e.g. PROJ-1,PROJ-2)", keyList).option("--execution <keys>", "Comma-separated test execution keys to remove (e.g. PROJ-200)", keyList);
+  examples(cmd, [
+    "PROJ-573 --test PROJ-1",
+    "PROJ-573 --execution PROJ-200",
+    "PROJ-573 --test PROJ-1 --execution PROJ-200"
+  ]);
   cmd.action(async (planKey, opts) => {
     assertAtLeastOne(opts, ["test", "execution"]);
     const client = getClient();
@@ -2840,9 +2924,9 @@ function remove3(parent) {
 
 // src/commands/xray/plan/update.ts
 function update8(parent) {
-  const cmd = parent.command("update").description("Update an Xray Test Plan issue").argument("<planKey>", "Test Plan issue key (e.g. QA-573)", issueKey).option("--summary <text>", "New summary (title)", text);
+  const cmd = parent.command("update").description("Update an Xray Test Plan issue").argument("<planKey>", "Test Plan issue key (e.g. PROJ-573)", issueKey).option("--summary <text>", "New summary (title)", text);
   textOrFileOption(cmd, "description", { description: "New Test Plan description" });
-  examples(cmd, ['QA-573 --summary "Updated plan title"', 'QA-573 --description "Revised scope"']);
+  examples(cmd, ['PROJ-573 --summary "Updated plan title"', 'PROJ-573 --description "Revised scope"']);
   cmd.action(async (planKey, opts) => {
     const description = resolveTextOrFile(opts, "description", { required: false });
     const client = getClient();
@@ -2857,10 +2941,10 @@ function registerPlanCommands(xray) {
     "Xray Test Plan issue management (CRUD, membership). To list tests inside a plan, use: xray test list --plan <key>."
   );
   examples(plan, [
-    'create --project QA --summary "Q3 regression plan"',
-    "add QA-573 --test QA-1,QA-2",
-    "add QA-573 --test QA-1 --execution QA-200",
-    "list --test QA-574"
+    'create --project PROJ --summary "Q3 regression plan"',
+    "add PROJ-573 --test PROJ-1,PROJ-2",
+    "add PROJ-573 --test PROJ-1 --execution PROJ-200",
+    "list --test PROJ-574"
   ]);
   create9(plan);
   update8(plan);
@@ -2872,8 +2956,8 @@ function registerPlanCommands(xray) {
 
 // src/commands/xray/precondition/add.ts
 function add4(parent) {
-  const cmd = parent.command("add").description("Add tests to a Pre-Condition").argument("<preKey>", "Pre-Condition issue key (e.g. BD-50)", issueKey).requiredOption("--test <keys>", "Comma-separated test issue keys to add (e.g. AI-1,AI-2)", keyList);
-  examples(cmd, ["BD-50 --test AI-1", "BD-50 --test AI-1,AI-2,AI-3"]);
+  const cmd = parent.command("add").description("Add tests to a Pre-Condition").argument("<preKey>", "Pre-Condition issue key (e.g. PROJ-50)", issueKey).requiredOption("--test <keys>", "Comma-separated test issue keys to add (e.g. PROJ-1,PROJ-2)", keyList);
+  examples(cmd, ["PROJ-50 --test PROJ-1", "PROJ-50 --test PROJ-1,PROJ-2,PROJ-3"]);
   cmd.action(async (preKey, opts) => {
     const client = getClient();
     const result = await client.preconditions.addTests({ preKey, keys: opts.test });
@@ -2981,7 +3065,7 @@ function buildPreconditionCustomFields(map, opts) {
 // src/commands/xray/precondition/create.ts
 function create10(parent) {
   const cmd = parent.command("create").description(
-    "Create a new Xray Pre-Condition issue. Note: the Pre-Condition issue type is only available in projects that have it configured (e.g. BD); it is not on the AI/QA scheme."
+    "Create a new Xray Pre-Condition issue. Note: the Pre-Condition issue type is only available in projects that have it configured (e.g. BD); it is not on your project scheme."
   ).requiredOption("--project <key>", "Project key (e.g. BD)", text).requiredOption("--summary <text>", "Pre-Condition summary (title)", text).addOption(
     new Option10("--type <type>", "Pre-Condition type").choices(["manual", "generic", "cucumber"]).default("manual")
   );
@@ -3020,8 +3104,8 @@ function create10(parent) {
 
 // src/commands/xray/precondition/delete.ts
 function deletePrecondition(parent) {
-  const cmd = parent.command("delete").description("Delete an Xray Pre-Condition issue").argument("<preKey>", "Pre-Condition issue key (e.g. BD-50)", issueKey);
-  examples(cmd, ["BD-50"]);
+  const cmd = parent.command("delete").description("Delete an Xray Pre-Condition issue").argument("<preKey>", "Pre-Condition issue key (e.g. PROJ-50)", issueKey);
+  examples(cmd, ["PROJ-50"]);
   cmd.action(async (preKey) => {
     const client = getClient();
     await deleteXrayIssue(client, preKey);
@@ -3033,8 +3117,8 @@ function deletePrecondition(parent) {
 function list12(parent) {
   const cmd = parent.command("list").description(
     "List Pre-Conditions that apply to a given test (inverse view). For the forward view (tests covered by a precondition), use: xray precondition add/remove."
-  ).requiredOption("--test <key>", "Test issue key whose pre-conditions to list (e.g. AI-584)", issueKey);
-  examples(cmd, ["--test AI-584"]);
+  ).requiredOption("--test <key>", "Test issue key whose pre-conditions to list (e.g. PROJ-584)", issueKey);
+  examples(cmd, ["--test PROJ-584"]);
   cmd.action(async (opts) => {
     const client = getClient();
     const preconditions = await client.xrayTests.getPreconditions({ testKey: opts.test });
@@ -3044,8 +3128,8 @@ function list12(parent) {
 
 // src/commands/xray/precondition/remove.ts
 function remove4(parent) {
-  const cmd = parent.command("remove").description("Remove tests from a Pre-Condition").argument("<preKey>", "Pre-Condition issue key (e.g. BD-50)", issueKey).requiredOption("--test <keys>", "Comma-separated test issue keys to remove (e.g. AI-1,AI-2)", keyList);
-  examples(cmd, ["BD-50 --test AI-1", "BD-50 --test AI-1,AI-2"]);
+  const cmd = parent.command("remove").description("Remove tests from a Pre-Condition").argument("<preKey>", "Pre-Condition issue key (e.g. PROJ-50)", issueKey).requiredOption("--test <keys>", "Comma-separated test issue keys to remove (e.g. PROJ-1,PROJ-2)", keyList);
+  examples(cmd, ["PROJ-50 --test PROJ-1", "PROJ-50 --test PROJ-1,PROJ-2"]);
   cmd.action(async (preKey, opts) => {
     const client = getClient();
     const result = await client.preconditions.removeTests({ preKey, keys: opts.test });
@@ -3056,10 +3140,10 @@ function remove4(parent) {
 // src/commands/xray/precondition/update.ts
 import { Option as Option11 } from "commander";
 function update9(parent) {
-  const cmd = parent.command("update").description("Update an Xray Pre-Condition issue").argument("<preKey>", "Pre-Condition issue key (e.g. BD-50)", issueKey).option("--summary <text>", "New summary (title)", text).addOption(new Option11("--type <type>", "New Pre-Condition type").choices(["manual", "generic", "cucumber"]));
+  const cmd = parent.command("update").description("Update an Xray Pre-Condition issue").argument("<preKey>", "Pre-Condition issue key (e.g. PROJ-50)", issueKey).option("--summary <text>", "New summary (title)", text).addOption(new Option11("--type <type>", "New Pre-Condition type").choices(["manual", "generic", "cucumber"]));
   textOrFileOption(cmd, "condition", { description: "New pre-condition body / definition text" });
   textOrFileOption(cmd, "description", { description: "New Pre-Condition issue description" });
-  examples(cmd, ['BD-50 --summary "Updated precondition"', 'BD-50 --type generic --condition "apiKey != null"']);
+  examples(cmd, ['PROJ-50 --summary "Updated precondition"', 'PROJ-50 --type generic --condition "apiKey != null"']);
   cmd.action(
     async (preKey, opts) => {
       const condition = resolveTextOrFile(opts, "condition", { required: false });
@@ -3097,12 +3181,12 @@ function update9(parent) {
 // src/commands/xray/precondition/index.ts
 function registerPreconditionCommands(xray) {
   const precondition = xray.command("precondition").description(
-    "Xray Pre-Condition issue management (CRUD, membership). Note: Pre-Condition issue type is only available in projects where it is configured (not AI/QA). To list tests covered by a precondition, use: xray test list --precondition <key>."
+    "Xray Pre-Condition issue management (CRUD, membership). Note: Pre-Condition issue type is only available in projects where it is configured (not your project). To list tests covered by a precondition, use: xray test list --precondition <key>."
   );
   examples(precondition, [
     'create --project BD --summary "User is logged in"',
-    "add BD-50 --test QA-1,QA-2",
-    "list --test AI-584"
+    "add PROJ-50 --test PROJ-1,PROJ-2",
+    "list --test PROJ-584"
   ]);
   create10(precondition);
   update9(precondition);
@@ -3124,7 +3208,7 @@ async function resolveRunId(client, o) {
 // src/commands/xray/run/defect/add.ts
 function add5(parent) {
   const cmd = parent.command("add").description("Link defect issues to a test run").argument("[runId]", "Test run id (from run list)", positiveInt).requiredOption("--defect <keys>", "Comma-separated defect issue keys to link", keyList).option("--execution <key>", "Test execution issue key (used with --test to resolve run id)", issueKey).option("--test <key>", "Test issue key (used with --execution to resolve run id)", issueKey);
-  examples(cmd, ["42 --defect BUG-1", "--execution QA-1 --test QA-2 --defect BUG-1,BUG-2"]);
+  examples(cmd, ["42 --defect BUG-1", "--execution PROJ-1 --test PROJ-2 --defect BUG-1,BUG-2"]);
   cmd.action(async (runId, opts) => {
     const client = getClient();
     const id = await resolveRunId(client, { runId, execution: opts.execution, test: opts.test });
@@ -3136,7 +3220,7 @@ function add5(parent) {
 // src/commands/xray/run/defect/remove.ts
 function remove5(parent) {
   const cmd = parent.command("remove").description("Unlink defect issues from a test run (per-key, reports failures without aborting)").argument("[runId]", "Test run id (from run list)", positiveInt).requiredOption("--defect <keys>", "Comma-separated defect issue keys to unlink", keyList).option("--execution <key>", "Test execution issue key (used with --test to resolve run id)", issueKey).option("--test <key>", "Test issue key (used with --execution to resolve run id)", issueKey);
-  examples(cmd, ["42 --defect BUG-1", "--execution QA-1 --test QA-2 --defect BUG-1,BUG-2"]);
+  examples(cmd, ["42 --defect BUG-1", "--execution PROJ-1 --test PROJ-2 --defect BUG-1,BUG-2"]);
   cmd.action(async (runId, opts) => {
     const client = getClient();
     const id = await resolveRunId(client, { runId, execution: opts.execution, test: opts.test });
@@ -3170,7 +3254,7 @@ function registerDefectCommands(run) {
   const defect = run.command("defect").description(
     "Manage defects linked to a test run. See also: run update --defect for the one-command fail+link loop."
   );
-  examples(defect, ["add --execution QA-1 --test QA-2 --defect BUG-1", "remove 42 --defect BUG-1"]);
+  examples(defect, ["add --execution PROJ-1 --test PROJ-2 --defect BUG-1", "remove 42 --defect BUG-1"]);
   add5(defect);
   remove5(defect);
 }
@@ -3196,7 +3280,7 @@ function inferContentType(fp) {
 }
 function add6(parent) {
   const cmd = parent.command("add").description("Attach a file as evidence to a test run").argument("[runId]", "Test run id (from run list)", positiveInt).requiredOption("--file <path>", "Path to the file to attach", filePath).option("--execution <key>", "Test execution issue key (used with --test to resolve run id)", issueKey).option("--test <key>", "Test issue key (used with --execution to resolve run id)", issueKey);
-  examples(cmd, ["42 --file screenshot.png", "--execution QA-1 --test QA-2 --file report.pdf"]);
+  examples(cmd, ["42 --file screenshot.png", "--execution PROJ-1 --test PROJ-2 --file report.pdf"]);
   cmd.action(async (runId, opts) => {
     const client = getClient();
     const id = await resolveRunId(client, { runId, execution: opts.execution, test: opts.test });
@@ -3212,7 +3296,7 @@ function add6(parent) {
 // src/commands/xray/run/evidence/delete.ts
 function deleteEvidence(parent) {
   const cmd = parent.command("delete").description("Delete an evidence attachment from a test run").argument("[runId]", "Test run id (from run list)", positiveInt).requiredOption("--evidence-id <id>", "Id of the evidence attachment (from evidence list)", positiveInt).option("--execution <key>", "Test execution issue key (used with --test to resolve run id)", issueKey).option("--test <key>", "Test issue key (used with --execution to resolve run id)", issueKey);
-  examples(cmd, ["42 --evidence-id 7", "--execution QA-1 --test QA-2 --evidence-id 7"]);
+  examples(cmd, ["42 --evidence-id 7", "--execution PROJ-1 --test PROJ-2 --evidence-id 7"]);
   cmd.action(async (runId, opts) => {
     const client = getClient();
     const id = await resolveRunId(client, { runId, execution: opts.execution, test: opts.test });
@@ -3224,7 +3308,7 @@ function deleteEvidence(parent) {
 // src/commands/xray/run/evidence/list.ts
 function list13(parent) {
   const cmd = parent.command("list").description("List evidence (attachments) on a test run").argument("[runId]", "Test run id (from run list)", positiveInt).option("--execution <key>", "Test execution issue key (used with --test to resolve run id)", issueKey).option("--test <key>", "Test issue key (used with --execution to resolve run id)", issueKey);
-  examples(cmd, ["42", "--execution QA-1 --test QA-2"]);
+  examples(cmd, ["42", "--execution PROJ-1 --test PROJ-2"]);
   cmd.action(async (runId, opts) => {
     const client = getClient();
     const id = await resolveRunId(client, { runId, execution: opts.execution, test: opts.test });
@@ -3237,7 +3321,7 @@ function list13(parent) {
 function registerEvidenceCommands(run) {
   const evidence = run.command("evidence").description("Manage evidence (file attachments) on a test run");
   examples(evidence, [
-    "add --execution QA-1 --test QA-2 --file screenshot.png",
+    "add --execution PROJ-1 --test PROJ-2 --file screenshot.png",
     "list 42",
     "delete 42 --evidence-id 7"
   ]);
@@ -3249,7 +3333,7 @@ function registerEvidenceCommands(run) {
 // src/commands/xray/run/field/get.ts
 function get4(parent) {
   const cmd = parent.command("get").description("Get a custom field value on a test run").argument("[runId]", "Test run id (from run list)", positiveInt).requiredOption("--field-id <id>", "Custom field id (from xray field list)", text).option("--execution <key>", "Test execution issue key (used with --test to resolve run id)", issueKey).option("--test <key>", "Test issue key (used with --execution to resolve run id)", issueKey);
-  examples(cmd, ["42 --field-id customfield_10100", "--execution QA-1 --test QA-2 --field-id customfield_10100"]);
+  examples(cmd, ["42 --field-id customfield_10100", "--execution PROJ-1 --test PROJ-2 --field-id customfield_10100"]);
   cmd.action(async (runId, opts) => {
     const client = getClient();
     const id = await resolveRunId(client, { runId, execution: opts.execution, test: opts.test });
@@ -3263,7 +3347,7 @@ function set(parent) {
   const cmd = parent.command("set").description("Set a custom field value on a test run").argument("[runId]", "Test run id (from run list)", positiveInt).requiredOption("--field-id <id>", "Custom field id (from xray field list)", text).requiredOption("--value <text>", "Value to set for the field", text).option("--execution <key>", "Test execution issue key (used with --test to resolve run id)", issueKey).option("--test <key>", "Test issue key (used with --execution to resolve run id)", issueKey);
   examples(cmd, [
     '42 --field-id customfield_10100 --value "approved"',
-    '--execution QA-1 --test QA-2 --field-id customfield_10100 --value "reviewed"'
+    '--execution PROJ-1 --test PROJ-2 --field-id customfield_10100 --value "reviewed"'
   ]);
   cmd.action(
     async (runId, opts) => {
@@ -3286,7 +3370,7 @@ function registerRunFieldCommands(run) {
 // src/commands/xray/run/get.ts
 function get5(parent) {
   const cmd = parent.command("get").description("Get a test run by id or by execution + test key").argument("[runId]", "Test run id (from run list)", positiveInt).option("--execution <key>", "Test execution issue key (used with --test to resolve run id)", issueKey).option("--test <key>", "Test issue key (used with --execution to resolve run id)", issueKey);
-  examples(cmd, ["42", "--execution QA-1 --test QA-2"]);
+  examples(cmd, ["42", "--execution PROJ-1 --test PROJ-2"]);
   cmd.action(async (runId, opts) => {
     const client = getClient();
     const id = await resolveRunId(client, { runId, ...opts });
@@ -3298,7 +3382,7 @@ function get5(parent) {
 // src/commands/xray/run/list.ts
 function list14(parent) {
   const cmd = parent.command("list").description("List test runs for a test execution (CLI-side slice with --limit/--start)").requiredOption("--execution <key>", "Test execution issue key", issueKey).option("--limit <number>", "Max results to return (1-200)", intInRange(1, 200), 50).option("--start <number>", "Starting index for pagination", nonNegativeInt);
-  examples(cmd, ["--execution QA-1", "--execution QA-1 --limit 10", "--execution QA-1 --limit 10 --start 10"]);
+  examples(cmd, ["--execution PROJ-1", "--execution PROJ-1 --limit 10", "--execution PROJ-1 --limit 10 --start 10"]);
   cmd.action(async (opts) => {
     const client = getClient();
     const runs = await client.testRuns.listByExecution({ execKey: opts.execution });
@@ -3311,7 +3395,7 @@ function list14(parent) {
 // src/commands/xray/run/step/list.ts
 function list15(parent) {
   const cmd = parent.command("list").description("List step results for a test run").argument("[runId]", "Test run id (from run list)", positiveInt).option("--execution <key>", "Test execution issue key (used with --test to resolve run id)", issueKey).option("--test <key>", "Test issue key (used with --execution to resolve run id)", issueKey);
-  examples(cmd, ["42", "--execution QA-1 --test QA-2"]);
+  examples(cmd, ["42", "--execution PROJ-1 --test PROJ-2"]);
   cmd.action(async (runId, opts) => {
     const client = getClient();
     const id = await resolveRunId(client, { runId, execution: opts.execution, test: opts.test });
@@ -3331,7 +3415,7 @@ function update10(parent) {
   textOrFileOption(cmd, "actual-result", { description: "Actual result text for this step" });
   examples(cmd, [
     "42 --step-id 1 --status PASS",
-    '--execution QA-1 --test QA-2 --step-id 2 --status FAIL --comment "button missing"',
+    '--execution PROJ-1 --test PROJ-2 --step-id 2 --status FAIL --comment "button missing"',
     '42 --step-id 1 --status PASS --actual-result "Form submitted successfully"'
   ]);
   cmd.action(
@@ -3355,7 +3439,7 @@ function update10(parent) {
 // src/commands/xray/run/step/index.ts
 function registerRunStepCommands(run) {
   const step = run.command("step").description("Manage step results within a test run. See also: xray step for test step definitions.");
-  examples(step, ["list --execution QA-1 --test QA-2", "update 42 --step-id 1 --status PASS"]);
+  examples(step, ["list --execution PROJ-1 --test PROJ-2", "update 42 --step-id 1 --status PASS"]);
   list15(step);
   update10(step);
 }
@@ -3366,8 +3450,8 @@ function update11(parent) {
   textOrFileOption(cmd, "comment", { description: "Comment text for this run" });
   examples(cmd, [
     "42 --status PASS",
-    '--execution QA-1 --test QA-2 --status FAIL --comment "broken"',
-    '--execution QA-1 --test QA-2 --status FAIL --comment "broken" --defect BUG-1'
+    '--execution PROJ-1 --test PROJ-2 --status FAIL --comment "broken"',
+    '--execution PROJ-1 --test PROJ-2 --status FAIL --comment "broken" --defect BUG-1'
   ]);
   cmd.action(
     async (runId, opts) => {
@@ -3394,12 +3478,12 @@ function registerRunCommands(xray) {
     "Manage test run results (status, comments, defects, evidence, steps). Every command accepts [runId] or --execution + --test."
   );
   examples(run, [
-    "get --execution QA-1 --test QA-2",
-    "list --execution QA-1",
-    'update --execution QA-1 --test QA-2 --status FAIL --comment "broken" --defect BUG-1',
+    "get --execution PROJ-1 --test PROJ-2",
+    "list --execution PROJ-1",
+    'update --execution PROJ-1 --test PROJ-2 --status FAIL --comment "broken" --defect BUG-1',
     "defect add 42 --defect BUG-1,BUG-2",
-    "evidence add --execution QA-1 --test QA-2 --file screenshot.png",
-    "step list --execution QA-1 --test QA-2",
+    "evidence add --execution PROJ-1 --test PROJ-2 --file screenshot.png",
+    "step list --execution PROJ-1 --test PROJ-2",
     "field get 42 --field-id customfield_10100"
   ]);
   get5(run);
@@ -3431,13 +3515,13 @@ function registerStatusCommands(xray) {
 
 // src/commands/xray/step/add.ts
 function add7(parent) {
-  const cmd = parent.command("add").description("Add a manual test step to a Test issue").requiredOption("--test <key>", "Test issue key (e.g. AI-584)", issueKey);
+  const cmd = parent.command("add").description("Add a manual test step to a Test issue").requiredOption("--test <key>", "Test issue key (e.g. PROJ-584)", issueKey);
   textOrFileOption(cmd, "action", { description: "Step action text (required: provide --action or --action-file)" });
   textOrFileOption(cmd, "data", { description: "Step test data text" });
   textOrFileOption(cmd, "result", { description: "Expected result text" });
   examples(cmd, [
-    '--test AI-584 --action "Open login page" --result "Login form is shown"',
-    '--test AI-584 --action "Submit form" --data "user=admin" --result "Dashboard loads"'
+    '--test PROJ-584 --action "Open login page" --result "Login form is shown"',
+    '--test PROJ-584 --action "Submit form" --data "user=admin" --result "Dashboard loads"'
   ]);
   cmd.action(
     async (opts) => {
@@ -3453,8 +3537,8 @@ function add7(parent) {
 
 // src/commands/xray/step/delete.ts
 function deleteStep(parent) {
-  const cmd = parent.command("delete").description("Delete a manual test step by ID").argument("<stepId>", "Step ID to delete (from step list)", positiveInt).requiredOption("--test <key>", "Test issue key (e.g. AI-584)", issueKey);
-  examples(cmd, ["3 --test AI-584"]);
+  const cmd = parent.command("delete").description("Delete a manual test step by ID").argument("<stepId>", "Step ID to delete (from step list)", positiveInt).requiredOption("--test <key>", "Test issue key (e.g. PROJ-584)", issueKey);
+  examples(cmd, ["3 --test PROJ-584"]);
   cmd.action(async (stepId, opts) => {
     const client = getClient();
     await client.testSteps.delete({ testKey: opts.test, stepId });
@@ -3464,8 +3548,8 @@ function deleteStep(parent) {
 
 // src/commands/xray/step/list.ts
 function list17(parent) {
-  const cmd = parent.command("list").description("List manual test steps for a Test issue").requiredOption("--test <key>", "Test issue key (e.g. AI-584)", issueKey);
-  examples(cmd, ["--test AI-584"]);
+  const cmd = parent.command("list").description("List manual test steps for a Test issue").requiredOption("--test <key>", "Test issue key (e.g. PROJ-584)", issueKey);
+  examples(cmd, ["--test PROJ-584"]);
   cmd.action(async (opts) => {
     const client = getClient();
     const steps = await client.testSteps.list({ testKey: opts.test });
@@ -3475,13 +3559,13 @@ function list17(parent) {
 
 // src/commands/xray/step/update.ts
 function update12(parent) {
-  const cmd = parent.command("update").description("Update a manual test step by ID").argument("<stepId>", "Step ID to update (from step list)", positiveInt).requiredOption("--test <key>", "Test issue key (e.g. AI-584)", issueKey);
+  const cmd = parent.command("update").description("Update a manual test step by ID").argument("<stepId>", "Step ID to update (from step list)", positiveInt).requiredOption("--test <key>", "Test issue key (e.g. PROJ-584)", issueKey);
   textOrFileOption(cmd, "action", { description: "New step action text" });
   textOrFileOption(cmd, "data", { description: "New step test data text" });
   textOrFileOption(cmd, "result", { description: "New expected result text" });
   examples(cmd, [
-    '3 --test AI-584 --action "Click submit button"',
-    '3 --test AI-584 --result "Confirmation email sent"'
+    '3 --test PROJ-584 --action "Click submit button"',
+    '3 --test PROJ-584 --result "Confirmation email sent"'
   ]);
   cmd.action(
     async (stepId, opts) => {
@@ -3505,7 +3589,7 @@ function registerStepCommands(xray) {
   const step = xray.command("step").description(
     "Manage manual test steps for a Test issue (scope: --test). Steps are ordered by insertion; use step list to see current ids."
   );
-  examples(step, ['add --test AI-584 --action "Open login" --result "Form shows"', "list --test AI-584"]);
+  examples(step, ['add --test PROJ-584 --action "Open login" --result "Form shows"', "list --test PROJ-584"]);
   list17(step);
   add7(step);
   update12(step);
@@ -3532,15 +3616,15 @@ function create11(parent) {
   textOrFileOption(cmd, "description", { description: "Test description" });
   examples(cmd, [
     [
-      `--project AI --summary "Login test" --type manual --steps '[{"action":"Open browser","result":"Browser opens"}]'`,
+      `--project PROJ --summary "Login test" --type manual --steps '[{"action":"Open browser","result":"Browser opens"}]'`,
       "Create manual test with step seed"
     ],
     [
-      '--project AI --summary "Login scenario" --type cucumber --cucumber-type scenario --gherkin "Given I am on login page\\nWhen I enter credentials\\nThen I am logged in"',
+      '--project PROJ --summary "Login scenario" --type cucumber --cucumber-type scenario --gherkin "Given I am on login page\\nWhen I enter credentials\\nThen I am logged in"',
       "Create cucumber test"
     ],
     [
-      '--project AI --summary "Perf baseline" --type generic --definition "Run k6 script and assert p95 < 500ms"',
+      '--project PROJ --summary "Perf baseline" --type generic --definition "Run k6 script and assert p95 < 500ms"',
       "Create generic test"
     ]
   ]);
@@ -3597,8 +3681,8 @@ function create11(parent) {
 
 // src/commands/xray/test/delete.ts
 function deleteTest(parent) {
-  const cmd = parent.command("delete").description("Delete an Xray Test issue").argument("<testKey>", "Test issue key (e.g. AI-584)", issueKey);
-  examples(cmd, ["AI-584"]);
+  const cmd = parent.command("delete").description("Delete an Xray Test issue").argument("<testKey>", "Test issue key (e.g. PROJ-584)", issueKey);
+  examples(cmd, ["PROJ-584"]);
   cmd.action(async (testKey) => {
     const client = getClient();
     await client.issues.delete({ issueKeyOrId: testKey });
@@ -3608,8 +3692,8 @@ function deleteTest(parent) {
 
 // src/commands/xray/test/get.ts
 function get6(parent) {
-  const cmd = parent.command("get").description("Get one or more Xray test issues by key").argument("<testKey...>", "One or more test issue keys (e.g. AI-584)", listOf(issueKey));
-  examples(cmd, ["AI-584", "AI-584 AI-585"]);
+  const cmd = parent.command("get").description("Get one or more Xray test issues by key").argument("<testKey...>", "One or more test issue keys (e.g. PROJ-584)", listOf(issueKey));
+  examples(cmd, ["PROJ-584", "PROJ-584 PROJ-585"]);
   cmd.action(async (testKeys) => {
     const client = getClient();
     const tests = await client.xrayTests.getTests({ keys: testKeys });
@@ -3622,7 +3706,7 @@ function list18(parent) {
   const cmd = parent.command("list").description(
     "List Xray Test issues by scope: all tests in a project, or tests belonging to a set, plan, execution, precondition, or folder. Note: use `jiradc issue search` for richer JQL when scoping by project."
   ).option("--project <text>", "Project key \u2014 list all tests in the project (or companion to --folder)", text).option("--set <key>", "Test Set issue key \u2014 list tests in this set", issueKey).option("--plan <key>", "Test Plan issue key \u2014 list tests in this plan", issueKey).option("--execution <key>", "Test Execution issue key \u2014 list tests in this execution", issueKey).option("--precondition <key>", "Precondition issue key \u2014 list tests with this precondition", issueKey).option("--folder <id>", "Folder id \u2014 list tests in this folder (requires --project)", positiveInt).option("--limit <number>", "Max results (1-50, applies to --project scope)", intInRange(1, 50), 25).option("--start <number>", "Starting index for pagination (applies to --project scope)", nonNegativeInt);
-  examples(cmd, ["--project QA", "--set QA-100", "--folder 818 --project QA"]);
+  examples(cmd, ["--project PROJ", "--set PROJ-100", "--folder 818 --project PROJ"]);
   cmd.action(
     async (opts) => {
       const client = getClient();
@@ -3694,7 +3778,7 @@ function list18(parent) {
 // src/commands/xray/test/update.ts
 import { Option as Option13 } from "commander";
 function update13(parent) {
-  const cmd = parent.command("update").description("Update an Xray Test issue").argument("<testKey>", "Test issue key (e.g. AI-584)", issueKey).option("--summary <text>", "New summary (title)", text).addOption(new Option13("--type <type>", "Test type").choices(["manual", "cucumber", "generic"])).addOption(
+  const cmd = parent.command("update").description("Update an Xray Test issue").argument("<testKey>", "Test issue key (e.g. PROJ-584)", issueKey).option("--summary <text>", "New summary (title)", text).addOption(new Option13("--type <type>", "Test type").choices(["manual", "cucumber", "generic"])).addOption(
     new Option13("--cucumber-type <cucumberType>", "Cucumber scenario type (required when --type cucumber)").choices([
       "scenario",
       "scenario-outline"
@@ -3704,8 +3788,8 @@ function update13(parent) {
   textOrFileOption(cmd, "definition", { description: "Generic test definition (required when --type generic)" });
   textOrFileOption(cmd, "description", { description: "Test description" });
   examples(cmd, [
-    'AI-584 --summary "Updated title"',
-    'AI-584 --type cucumber --cucumber-type scenario --gherkin "Given I open the app"'
+    'PROJ-584 --summary "Updated title"',
+    'PROJ-584 --type cucumber --cucumber-type scenario --gherkin "Given I open the app"'
   ]);
   cmd.action(
     async (testKey, opts) => {
@@ -3759,7 +3843,7 @@ function update13(parent) {
 // src/commands/xray/test/index.ts
 function registerTestCommands(xray) {
   const test = xray.command("test").description("Xray Test issue management (CRUD)");
-  examples(test, ["get AI-584", 'create --project AI --summary "Login" --type manual']);
+  examples(test, ["get PROJ-584", 'create --project PROJ --summary "Login" --type manual']);
   get6(test);
   create11(test);
   update13(test);
@@ -3769,8 +3853,8 @@ function registerTestCommands(xray) {
 
 // src/commands/xray/testset/add.ts
 function add8(parent) {
-  const cmd = parent.command("add").description("Add tests to a Test Set").argument("<setKey>", "Test Set issue key (e.g. AI-100)", issueKey).requiredOption("--test <keys>", "Comma-separated test issue keys to add (e.g. AI-1,AI-2)", keyList);
-  examples(cmd, ["AI-100 --test AI-1", "AI-100 --test AI-1,AI-2,AI-3"]);
+  const cmd = parent.command("add").description("Add tests to a Test Set").argument("<setKey>", "Test Set issue key (e.g. PROJ-100)", issueKey).requiredOption("--test <keys>", "Comma-separated test issue keys to add (e.g. PROJ-1,PROJ-2)", keyList);
+  examples(cmd, ["PROJ-100 --test PROJ-1", "PROJ-100 --test PROJ-1,PROJ-2,PROJ-3"]);
   cmd.action(async (setKey, opts) => {
     const client = getClient();
     const result = await client.testSets.addTests({ setKey, keys: opts.test });
@@ -3783,8 +3867,8 @@ function create12(parent) {
   const cmd = parent.command("create").description("Create a new Xray Test Set issue").requiredOption("--project <key>", "Project key (e.g. AI)", text).requiredOption("--summary <text>", "Test Set summary (title)", text);
   textOrFileOption(cmd, "description", { description: "Test Set description" });
   examples(cmd, [
-    '--project AI --summary "Smoke Test Set"',
-    '--project AI --summary "Regression Set" --description "All regression tests"'
+    '--project PROJ --summary "Smoke Test Set"',
+    '--project PROJ --summary "Regression Set" --description "All regression tests"'
   ]);
   cmd.action(async (opts) => {
     const description = resolveTextOrFile(opts, "description", { required: false });
@@ -3801,8 +3885,8 @@ function create12(parent) {
 
 // src/commands/xray/testset/delete.ts
 function deleteTestset(parent) {
-  const cmd = parent.command("delete").description("Delete an Xray Test Set issue").argument("<setKey>", "Test Set issue key (e.g. AI-100)", issueKey);
-  examples(cmd, ["AI-100"]);
+  const cmd = parent.command("delete").description("Delete an Xray Test Set issue").argument("<setKey>", "Test Set issue key (e.g. PROJ-100)", issueKey);
+  examples(cmd, ["PROJ-100"]);
   cmd.action(async (setKey) => {
     const client = getClient();
     await deleteXrayIssue(client, setKey);
@@ -3814,8 +3898,8 @@ function deleteTestset(parent) {
 function list19(parent) {
   const cmd = parent.command("list").description(
     "List Test Sets that contain a given test (inverse view). For the forward view (tests inside a set), use: xray test list --set <key>"
-  ).requiredOption("--test <key>", "Test issue key whose sets to list (e.g. AI-584)", issueKey);
-  examples(cmd, ["--test AI-584"]);
+  ).requiredOption("--test <key>", "Test issue key whose sets to list (e.g. PROJ-584)", issueKey);
+  examples(cmd, ["--test PROJ-584"]);
   cmd.action(async (opts) => {
     const client = getClient();
     const sets = await client.xrayTests.getTestSets({ testKey: opts.test });
@@ -3825,8 +3909,8 @@ function list19(parent) {
 
 // src/commands/xray/testset/remove.ts
 function remove6(parent) {
-  const cmd = parent.command("remove").description("Remove tests from a Test Set").argument("<setKey>", "Test Set issue key (e.g. AI-100)", issueKey).requiredOption("--test <keys>", "Comma-separated test issue keys to remove (e.g. AI-1,AI-2)", keyList);
-  examples(cmd, ["AI-100 --test AI-1", "AI-100 --test AI-1,AI-2"]);
+  const cmd = parent.command("remove").description("Remove tests from a Test Set").argument("<setKey>", "Test Set issue key (e.g. PROJ-100)", issueKey).requiredOption("--test <keys>", "Comma-separated test issue keys to remove (e.g. PROJ-1,PROJ-2)", keyList);
+  examples(cmd, ["PROJ-100 --test PROJ-1", "PROJ-100 --test PROJ-1,PROJ-2"]);
   cmd.action(async (setKey, opts) => {
     const client = getClient();
     const result = await client.testSets.removeTests({ setKey, keys: opts.test });
@@ -3836,9 +3920,9 @@ function remove6(parent) {
 
 // src/commands/xray/testset/update.ts
 function update14(parent) {
-  const cmd = parent.command("update").description("Update an Xray Test Set issue").argument("<setKey>", "Test Set issue key (e.g. AI-100)", issueKey).option("--summary <text>", "New summary (title)", text);
+  const cmd = parent.command("update").description("Update an Xray Test Set issue").argument("<setKey>", "Test Set issue key (e.g. PROJ-100)", issueKey).option("--summary <text>", "New summary (title)", text);
   textOrFileOption(cmd, "description", { description: "New Test Set description" });
-  examples(cmd, ['AI-100 --summary "Updated smoke set"', 'AI-100 --description "New description"']);
+  examples(cmd, ['PROJ-100 --summary "Updated smoke set"', 'PROJ-100 --description "New description"']);
   cmd.action(async (setKey, opts) => {
     const description = resolveTextOrFile(opts, "description", { required: false });
     const client = getClient();
@@ -3852,7 +3936,7 @@ function registerTestsetCommands(xray) {
   const testset = xray.command("testset").description(
     "Xray Test Set issue management (CRUD, membership). To list tests inside a set, use: xray test list --set <key>"
   );
-  examples(testset, ['create --project AI --summary "Smoke tests"', "add QA-100 --test QA-1,QA-2"]);
+  examples(testset, ['create --project PROJ --summary "Smoke tests"', "add PROJ-100 --test PROJ-1,PROJ-2"]);
   create12(testset);
   update14(testset);
   deleteTestset(testset);
@@ -3864,7 +3948,7 @@ function registerTestsetCommands(xray) {
 // src/commands/xray/index.ts
 function registerXrayCommands(program) {
   const xray = program.command("xray").description("Xray test management (tests, runs, repository, import/export)");
-  examples(xray, ["test get AI-584"]);
+  examples(xray, ["test get PROJ-584"]);
   registerStatusCommands(xray);
   registerFieldCommands2(xray);
   registerTestCommands(xray);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jiradc-cli",
-  "version": "1.0.29",
+  "version": "1.0.31",
   "publish": true,
   "type": "module",
   "main": "dist/index.js",
@@ -23,9 +23,9 @@
     "tsx": "^4.19.2",
     "typescript": "^5.7.2",
     "vitest": "^4.0.16",
+    "cli-utils": "1.0.0",
     "config-eslint": "0.0.0",
-    "config-typescript": "0.0.0",
-    "cli-utils": "1.0.0"
+    "config-typescript": "0.0.0"
   },
   "engines": {
     "node": ">=22.0.0"