jiradc-cli 1.0.37 → 1.0.39

package/dist/index.js

@@ -227,6 +227,17 @@ function subEntityOption(cmd, entity, opts = {}) {
   const description = `${entity.charAt(0).toUpperCase()}${entity.slice(1)} id`;
   return defineOption(cmd, `--${entity}-id <id>`, description, numeric ? positiveInt : text, opts.mandatory);
 }
+function paginationOptions(cmd, opts = {}) {
+  const max = opts.maxLimit ?? 1e3;
+  const def = opts.defaultLimit ?? 25;
+  cmd.option("--limit <n>", `Max results per page (1-${max})`, intInRange(1, max), def);
+  if (opts.startIsToken) {
+    cmd.option("--start <indexOrToken>", "Pagination cursor: 0-based offset or opaque next-page token", text);
+  } else {
+    cmd.option("--start <index>", "Pagination offset (0-based)", nonNegativeInt);
+  }
+  return cmd;
+}
 function bodyOption(cmd, opts = {}) {
   return textOrFileOption(cmd, "body", { description: "Prose body content", ...opts });
 }
@@ -677,9 +688,6 @@ async function runCli(program, opts) {
 import { styleText } from "util";
 import { Command as Command17 } from "commander";
 
-// src/commands/board/issues.ts
-import { Argument } from "commander";
-
 // src/utils/client.ts
 import { JiraClient } from "jira-data-center-client";
 function getClient() {
@@ -716,8 +724,12 @@ function transformPaged(response, fn) {
     const mapped2 = response.values.map(fn);
     return { startAt, maxResults, total, isLast: startAt + mapped2.length >= total, values: mapped2 };
   }
-  const mapped = response.worklogs.map(fn);
-  return { startAt, maxResults, total, isLast: startAt + mapped.length >= total, worklogs: mapped };
+  if ("worklogs" in response) {
+    const mapped2 = response.worklogs.map(fn);
+    return { startAt, maxResults, total, isLast: startAt + mapped2.length >= total, worklogs: mapped2 };
+  }
+  const mapped = response.comments.map(fn);
+  return { startAt, maxResults, total, isLast: startAt + mapped.length >= total, comments: mapped };
 }
 
 // src/utils/transformers/user.ts
@@ -766,6 +778,31 @@ function transformProject(p) {
     ...lead ? { lead: transformUser(lead) } : {}
   };
 }
+function transformProjectDetail(p) {
+  const {
+    self: _self,
+    avatarUrls: _avatarUrls,
+    expand: _expand,
+    // Roles arrive as a map of name to REST URL. Nothing in this CLI follows
+    // one, so the names alone would be a dead end for the caller.
+    roles: _roles,
+    lead,
+    issueTypes,
+    components,
+    versions: versions2,
+    ...rest
+  } = p;
+  return {
+    ...rest,
+    url: projectBrowseUrl(p.key),
+    ...lead ? { lead: transformUser(lead) } : {},
+    ...issueTypes ? { issueTypes: issueTypes.map((t) => t.name) } : {},
+    // Always present on a single-project read, so an absent array means empty
+    // rather than unknown.
+    components: { count: components?.length ?? 0, use: `jiradc component list --project ${p.key}` },
+    versions: { count: versions2?.length ?? 0, use: `jiradc project versions ${p.key}` }
+  };
+}
 
 // src/utils/transformers/component.ts
 function componentBrowseUrl(projectKey) {
@@ -1222,7 +1259,19 @@ function transformFolderTree(root) {
   return transformFolderNode(root);
 }
 
+// src/commands/board/get.ts
+function get(parent) {
+  const cmd = parent.command("get").description("Get a board by ID").argument("<id>", "Board ID", positiveInt);
+  examples(cmd, ["42"]);
+  cmd.action(async (id) => {
+    const client = getClient();
+    const result = await client.agile.getBoard(id);
+    output(transformBoard(result));
+  });
+}
+
 // src/commands/board/issues.ts
+import { Argument } from "commander";
 function issues(parent) {
   const cmd = parent.command("issues").description("Get issues for a board").addArgument(new Argument("<id>", "Board ID").argParser(positiveInt)).option("--limit <number>", "Max results (1-50, Jira DC caps at 50)", intInRange(1, 50), 25).option("--start <number>", "Starting index for pagination", nonNegativeInt).option("--fields <fields>", "Comma-separated field names to return", text).option("--jql <jql>", "Additional JQL filter within the board", text);
   examples(cmd, [
@@ -1265,8 +1314,9 @@ function list(parent) {
 // src/commands/board/index.ts
 function registerBoardCommands(program) {
   const board = program.command("board").description("Board operations");
-  examples(board, ["list", "list --type scrum --project PROJ", "issues 42 --limit 20"]);
+  examples(board, ["list", "list --type scrum --project PROJ", "get 42", "issues 42 --limit 20"]);
   list(board);
+  get(board);
   issues(board);
 }
 
@@ -1279,7 +1329,7 @@ var ASSIGNEE_TYPES = [
   "UNASSIGNED"
 ];
 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));
+  const cmd = parent.command("create").description("Create a new component in a project").requiredOption("--project <key>", "Project key (e.g., PROJ)", 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 PROJ --name Backend",
@@ -1314,7 +1364,7 @@ function deleteComponent(parent) {
 }
 
 // src/commands/component/get.ts
-function get(parent) {
+function get2(parent) {
   const cmd = parent.command("get").description("Get a component by ID").argument("<id>", "Component ID", positiveInt);
   examples(cmd, ["11289"]);
   cmd.action(async (id) => {
@@ -1337,7 +1387,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);
+  const cmd = parent.command("list").description("List all components for a project").requiredOption("--project <key>", "Project key (e.g., PROJ)", text);
   examples(cmd, ["--project PROJ"]);
   cmd.action(async (opts) => {
     const client = getClient();
@@ -1393,20 +1443,36 @@ function registerComponentCommands(program) {
     "issue-count 11289"
   ]);
   list2(component);
-  get(component);
+  get2(component);
   create(component);
   update(component);
   deleteComponent(component);
   issueCount(component);
 }
 
+// src/utils/field-search.ts
+function tier(field, keyword) {
+  const id = field.id.toLowerCase();
+  const name = (field.name ?? "").toLowerCase();
+  if (id === keyword) return 0;
+  if (name === keyword) return field.custom === true ? 2 : 1;
+  return field.custom === true ? 4 : 3;
+}
+function rankFieldMatches(fields, keyword, limit) {
+  const needle = keyword.toLowerCase();
+  const matches = fields.filter(
+    (f) => f.id.toLowerCase().includes(needle) || (f.name ?? "").toLowerCase().includes(needle)
+  );
+  return matches.sort((a, b) => tier(a, needle) - tier(b, needle)).slice(0, limit);
+}
+
 // src/commands/field/search.ts
 function search(parent) {
-  const cmd = parent.command("search").description("Search for fields by name or ID").argument("<keyword>", "Search keyword", text).option("--limit <number>", "Maximum number of results (1-1000)", intInRange(1, 1e3), 25);
+  const cmd = parent.command("search").description("Search for fields by name or ID").argument("<keyword>", "Search keyword", nonEmpty).option("--limit <number>", "Maximum number of results (1-1000)", intInRange(1, 1e3), 25);
   examples(cmd, ["epic", "customfield_10100", "priority --limit 5"]);
   cmd.action(async (keyword, opts) => {
     const client = getClient();
-    const result = await client.fields.search(keyword, opts.limit);
+    const result = rankFieldMatches(await client.fields.getAll(), keyword, opts.limit);
     output(result.map(transformField));
   });
 }
@@ -1621,13 +1687,12 @@ function registerAttachmentCommands(parent) {
 
 // src/commands/issue/batch-changelog.ts
 function batchChangelog(parent) {
-  const cmd = parent.command("batch-changelog").description("Get changelogs for multiple issues at once").argument("<keys>", "Comma-separated issue keys", text).option("--limit <number>", "Max changelog entries per issue (1-50, Jira DC caps at 50)", intInRange(1, 50), 25);
+  const cmd = parent.command("batch-changelog").description("Get changelogs for multiple issues at once").argument("<keys>", "Comma-separated issue keys", keyList).option("--limit <number>", "Max changelog entries per issue (1-50, Jira DC caps at 50)", intInRange(1, 50), 25);
   examples(cmd, ["PROJ-1,PROJ-2,PROJ-3", "PROJ-123,PROJ-124 --limit 10"]);
   cmd.action(async (keys, opts) => {
     const client = getClient();
-    const keyList2 = keys.split(",").map((k) => k.trim());
     const entries = await Promise.all(
-      keyList2.map(async (key) => {
+      keys.map(async (key) => {
         try {
           const data = await client.issues.getChangelog({ issueKeyOrId: key, maxResults: opts.limit });
           return [key, data];
@@ -1794,6 +1859,37 @@ function deleteComment(parent) {
   });
 }
 
+// src/commands/issue/comment/get.ts
+function get3(parent) {
+  const cmd = parent.command("get").description("Get a single comment on an issue").argument("<key>", "Issue key", issueKey);
+  subEntityOption(cmd, "comment", { mandatory: true });
+  examples(cmd, ["PROJ-123 --comment-id 12345"]);
+  cmd.action(async (key, opts) => {
+    const client = getClient();
+    const result = await client.issues.getComment({
+      issueKeyOrId: key,
+      commentId: String(opts.commentId)
+    });
+    output(transformComment(result));
+  });
+}
+
+// src/commands/issue/comment/list.ts
+function list4(parent) {
+  const cmd = parent.command("list").description("List comments on an issue").argument("<key>", "Issue key", issueKey);
+  paginationOptions(cmd);
+  examples(cmd, ["PROJ-123", "PROJ-123 --limit 10", "PROJ-123 --start 10 --limit 5"]);
+  cmd.action(async (key, opts) => {
+    const client = getClient();
+    const result = await client.issues.getComments({
+      issueKeyOrId: key,
+      startAt: opts.start,
+      maxResults: opts.limit
+    });
+    output(transformPaged(result, transformComment));
+  });
+}
+
 // src/commands/issue/comment/update.ts
 function update2(parent) {
   const cmd = parent.command("update").description("Update an existing comment").argument("<key>", "Issue key", issueKey);
@@ -1816,10 +1912,14 @@ function update2(parent) {
 function registerCommentCommands(parent) {
   const comment = parent.command("comment").description("Comment operations");
   examples(comment, [
+    "list PROJ-123",
+    "get PROJ-123 --comment-id 12345",
     'create PROJ-123 --body "Fixed in latest build"',
     'update PROJ-123 --comment-id 12345 --body "Updated comment text"',
     "delete PROJ-123 --comment-id 12345"
   ]);
+  list4(comment);
+  get3(comment);
   create2(comment);
   update2(comment);
   deleteComment(comment);
@@ -2012,6 +2112,7 @@ var DEFAULT_FIELDS = [...SEARCH_DEFAULT_FIELDS, "description", "comment"];
 // src/utils/field-selectors.ts
 var WILDCARD = "*";
 var NEGATION = "-";
+var UNPUBLISHED_SELECTORS = ["parent"];
 function buildFieldNameIndex(fields) {
   const ids = /* @__PURE__ */ new Set();
   const idsByLower = /* @__PURE__ */ new Map();
@@ -2031,6 +2132,10 @@ function buildFieldNameIndex(fields) {
     record(field.name, field.id);
     for (const clause of field.clauseNames ?? []) record(clause, field.id);
   }
+  for (const id of UNPUBLISHED_SELECTORS) {
+    ids.add(id);
+    if (!idsByLower.has(id)) idsByLower.set(id, id);
+  }
   return { ids, idsByLower, byName };
 }
 function candidatesFor(token, index) {
@@ -2114,7 +2219,7 @@ async function selectFields(client, opts, defaults) {
 }
 
 // src/commands/issue/get.ts
-function get2(parent) {
+function get4(parent) {
   const cmd = parent.command("get").description("Get issue details").argument("<key>", "Issue key", issueKey).option("--fields <fields>", "Comma-separated fields to return, by name or id", text).option("--all-fields", "Return all fields instead of defaults").option("--expand <expand>", 'Expand options (e.g., "transitions", "changelog")', text);
   examples(cmd, [
     "PROJ-123",
@@ -2236,7 +2341,7 @@ async function fetchEveryPage(fetchPage, opts) {
 // src/commands/issue/search.ts
 var MAX_PAGE_SIZE = 50;
 function search2(parent) {
-  const cmd = parent.command("search").description("Search issues using JQL").argument("<jql>", "JQL query string", text).option(
+  const cmd = parent.command("search").description("Search issues using JQL").argument("<jql>", "JQL query string", nonEmpty).option(
     "--limit <number>",
     `Max results (1-${MAX_PAGE_SIZE}, Jira DC caps at ${MAX_PAGE_SIZE})`,
     intInRange(1, MAX_PAGE_SIZE),
@@ -2527,7 +2632,7 @@ function deleteWorklog(parent) {
 }
 
 // src/commands/issue/worklog/list.ts
-function list4(parent) {
+function list5(parent) {
   const cmd = parent.command("list").description("Get worklogs for an issue").argument("<key>", "Issue key", issueKey).option("--start <number>", "Starting index for pagination", nonNegativeInt).option("--limit <number>", "Max results per page (1-1000)", intInRange(1, 1e3), 25);
   examples(cmd, ["PROJ-123", "PROJ-123 --limit 10", "PROJ-123 --start 10 --limit 5"]);
   cmd.action(async (key, opts) => {
@@ -2582,7 +2687,7 @@ function registerWorklogCommands(parent) {
     "delete PROJ-123 --worklog-id 12345"
   ]);
   create4(worklog);
-  list4(worklog);
+  list5(worklog);
   update4(worklog);
   deleteWorklog(worklog);
 }
@@ -2598,7 +2703,7 @@ function registerIssueCommands(program) {
     "transition PROJ-123 --to 11",
     "attachment list PROJ-123"
   ]);
-  get2(issue);
+  get4(issue);
   search2(issue);
   create3(issue);
   update3(issue);
@@ -2622,8 +2727,19 @@ function registerIssueCommands(program) {
   devStatus(issue);
 }
 
+// src/commands/project/get.ts
+function get5(parent) {
+  const cmd = parent.command("get").description("Get a single project by key or ID").argument("<key>", "Project key or ID", nonEmpty);
+  examples(cmd, ["PROJ", "10000"]);
+  cmd.action(async (key) => {
+    const client = getClient();
+    const result = await client.projects.get({ projectKeyOrId: key });
+    output(transformProjectDetail(result));
+  });
+}
+
 // src/commands/project/list.ts
-function list5(parent) {
+function list6(parent) {
   const cmd = parent.command("list").description("List all projects").option("--expand <expand>", 'Expand options (e.g., "description,lead")', text).option("--include-archived", "Include archived projects (default: false)");
   examples(cmd, ["", "--expand description,lead", "--include-archived"]);
   cmd.action(async (opts) => {
@@ -2635,7 +2751,7 @@ function list5(parent) {
 
 // src/commands/project/versions.ts
 function versions(parent) {
-  const cmd = parent.command("versions").description("Get all versions for a project").argument("<key>", "Project key", text).option("--expand <expand>", "Expand options", text);
+  const cmd = parent.command("versions").description("Get all versions for a project").argument("<key>", "Project key", nonEmpty).option("--expand <expand>", "Expand options", text);
   examples(cmd, ["PROJ", "PROJ --expand operations"]);
   cmd.action(async (key, opts) => {
     const client = getClient();
@@ -2647,8 +2763,9 @@ function versions(parent) {
 // src/commands/project/index.ts
 function registerProjectCommands(program) {
   const project = program.command("project").description("Project operations");
-  examples(project, ["list", "versions PROJ"]);
-  list5(project);
+  examples(project, ["list", "get PROJ", "versions PROJ"]);
+  get5(project);
+  list6(project);
   versions(project);
 }
 
@@ -2684,6 +2801,17 @@ function deleteSprint(parent) {
   });
 }
 
+// src/commands/sprint/get.ts
+function get6(parent) {
+  const cmd = parent.command("get").description("Get a sprint by ID").argument("<id>", "Sprint ID", positiveInt);
+  examples(cmd, ["123"]);
+  cmd.action(async (id) => {
+    const client = getClient();
+    const result = await client.agile.getSprint(id);
+    output(transformSprint(result));
+  });
+}
+
 // src/commands/sprint/issues.ts
 import { Argument as Argument3 } from "commander";
 function issues2(parent) {
@@ -2710,7 +2838,7 @@ function issues2(parent) {
 // src/commands/sprint/list.ts
 import { Option as Option8 } from "commander";
 var SPRINT_STATES = ["future", "active", "closed"];
-function list6(parent) {
+function list7(parent) {
   const cmd = parent.command("list").description("List sprints for a board").requiredOption("--board <id>", "Board ID", positiveInt).addOption(new Option8("--state <state>", "Filter by sprint state").choices(SPRINT_STATES));
   examples(cmd, ["--board 42", "--board 42 --state active"]);
   cmd.action(async (opts) => {
@@ -2755,10 +2883,12 @@ function registerSprintCommands(program) {
   examples(sprint, [
     "list --board 42",
     "list --board 42 --state active",
+    "get 123",
     "issues 123 --limit 20",
     'create --board 42 --name "Sprint 10" --start-date 2026-04-01 --end-date 2026-04-14'
   ]);
-  list6(sprint);
+  list7(sprint);
+  get6(sprint);
   issues2(sprint);
   create5(sprint);
   update5(sprint);
@@ -2811,7 +2941,7 @@ function create6(parent) {
 }
 
 // src/commands/token/list.ts
-function list7(parent) {
+function list8(parent) {
   const cmd = parent.command("list").description("List Personal Access Tokens owned by the authenticated user (secrets not included)").option("--basic-username <u>", "Override $JIRA_BASIC_USERNAME", text).option(
     "--basic-password <p>",
     "Override $JIRA_BASIC_PASSWORD (caution: visible in process table; prefer the env var)",
@@ -2855,13 +2985,13 @@ function registerTokenCommands(program) {
     "\nAuth:\n  Requires JIRA_BASIC_USERNAME + JIRA_BASIC_PASSWORD\n  (or --basic-username / --basic-password on any subcommand)."
   );
   create6(token);
-  list7(token);
+  list8(token);
   revoke(token);
 }
 
 // src/commands/user/get.ts
-function get3(parent) {
-  const cmd = parent.command("get").description("Get a user profile by exact username or key").argument("<username>", "Username or user key", text).option("--by-key", "Treat the positional argument as a user key instead of a username");
+function get7(parent) {
+  const cmd = parent.command("get").description("Get a user profile by exact username or key").argument("<username>", "Username or user key", nonEmpty).option("--by-key", "Treat the positional argument as a user key instead of a username");
   examples(cmd, ["jsmith", "JIRAUSER10100 --by-key"]);
   cmd.action(async (identifier, opts) => {
     const client = getClient();
@@ -2883,7 +3013,7 @@ function me(parent) {
 
 // src/commands/user/search.ts
 function search3(parent) {
-  const cmd = parent.command("search").description("Search users by partial username, display name or email").argument("<query>", "Search query", text).option("--limit <n>", "Maximum results (1-50)", intInRange(1, 50), 25).option("--start <n>", "Starting index (pagination offset)", nonNegativeInt, 0).option("--include-inactive", "Include inactive users in results", false);
+  const cmd = parent.command("search").description("Search users by partial username, display name or email").argument("<query>", "Search query", nonEmpty).option("--limit <n>", "Maximum results (1-50)", intInRange(1, 50), 25).option("--start <n>", "Starting index (pagination offset)", nonNegativeInt, 0).option("--include-inactive", "Include inactive users in results", false);
   examples(cmd, ["Smith", '"John Smith"', "jsmith@example.com --limit 5"]);
   cmd.action(async (query, opts) => {
     const client = getClient();
@@ -2903,7 +3033,7 @@ function registerUserCommands(program) {
   const user = program.command("user").description("User operations");
   examples(user, ["me", "get jsmith", "search Smith"]);
   me(user);
-  get3(user);
+  get7(user);
   search3(user);
 }
 
@@ -2938,8 +3068,8 @@ function add(parent) {
     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 list21 of lists) {
+        const tests = Array.isArray(list21) ? list21 : list21.tests ?? [];
         for (const t of tests) {
           if (t.key) keys.add(String(t.key));
         }
@@ -2986,7 +3116,7 @@ function deleteXrayIssue(client, key) {
 
 // src/commands/xray/execution/create.ts
 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);
+  const cmd = parent.command("create").description("Create a new Xray Test Execution issue").requiredOption("--project <key>", "Project key (e.g. PROJ)", text).requiredOption("--summary <text>", "Test Execution summary (title)", text);
   textOrFileOption(cmd, "description", { description: "Test Execution description" });
   examples(cmd, [
     '--project PROJ --summary "Sprint 42 regression run"',
@@ -3017,7 +3147,7 @@ function deleteExecution(parent) {
 }
 
 // src/commands/xray/execution/list.ts
-function list8(parent) {
+function list9(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. PROJ-584)", issueKey);
@@ -3068,7 +3198,7 @@ function registerExecutionCommands(xray) {
   deleteExecution(execution2);
   add(execution2);
   remove(execution2);
-  list8(execution2);
+  list9(execution2);
 }
 
 // src/commands/xray/export/feature.ts
@@ -3096,7 +3226,7 @@ function registerExportCommands(xray) {
 }
 
 // src/commands/xray/field/list.ts
-function list9(parent) {
+function list10(parent) {
   const cmd = parent.command("list").description("List Xray custom fields available on this instance");
   examples(cmd, [""]);
   cmd.action(async () => {
@@ -3109,12 +3239,12 @@ function list9(parent) {
 function registerFieldCommands2(xray) {
   const field = xray.command("field").description("Xray field discovery");
   examples(field, ["list"]);
-  list9(field);
+  list10(field);
 }
 
 // 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. PROJ-1,PROJ-2)", keyList);
+  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. PROJ)", 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();
@@ -3129,7 +3259,7 @@ function add2(parent) {
 
 // src/commands/xray/folder/create.ts
 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);
+  const cmd = parent.command("create").description("Create a new folder in the test repository").requiredOption("--project <key>", "Project key (e.g. PROJ)", text).option("--parent-id <id>", "Parent folder id (-1 = root)", integer, -1).requiredOption("--name <text>", "Folder name", text);
   examples(cmd, [
     "--project PROJ --name Smoke",
     '--project PROJ --parent-id -1 --name "Regression Suite"',
@@ -3148,7 +3278,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);
+  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. PROJ)", text);
   examples(cmd, ["818 --project PROJ", "42 --project PROJ"]);
   cmd.action(async (folderId, opts) => {
     const client = getClient();
@@ -3158,8 +3288,8 @@ 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);
+function list11(parent) {
+  const cmd = parent.command("list").description("List the test repository folder tree for a project").requiredOption("--project <key>", "Project key (e.g. PROJ)", text);
   examples(cmd, ["--project PROJ", "--project PROJ"]);
   cmd.action(async (opts) => {
     const client = getClient();
@@ -3170,7 +3300,7 @@ 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. PROJ-1,PROJ-2)", keyList);
+  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. PROJ)", 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();
@@ -3185,7 +3315,7 @@ function remove2(parent) {
 
 // src/commands/xray/folder/update.ts
 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);
+  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. PROJ)", text).option("--name <text>", "New folder name", text).option("--rank <id>", "New folder rank/position", positiveInt);
   examples(cmd, [
     '818 --project PROJ --name "New Name"',
     "818 --project PROJ --rank 2",
@@ -3212,7 +3342,7 @@ function registerFolderCommands(xray) {
     "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 PROJ", "create --project PROJ --parent-id -1 --name Smoke"]);
-  list10(folder);
+  list11(folder);
   create8(folder);
   update7(folder);
   deleteFolder(folder);
@@ -3230,7 +3360,7 @@ function execution(parent) {
   const cmd = parent.command("execution").description("Import test execution results into Xray").requiredOption("--file <path>", "Path to the result file", filePath).addOption(
     new Option10(
       "--format <format>",
-      "Result format. xray/cucumber/behave: JSON body, no --project/--execution required. junit/testng/nunit/xunit/robot: XML body, requires --project OR --execution."
+      "Result format. xray/cucumber/behave: JSON body, no --project/--execution required. junit/testng/nunit/xunit/robot: XML body, requires either --project or --execution."
     ).choices(FORMATS).makeOptionMandatory()
   ).option(
     "--project <text>",
@@ -3320,7 +3450,7 @@ function add3(parent) {
 
 // src/commands/xray/plan/create.ts
 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);
+  const cmd = parent.command("create").description("Create a new Xray Test Plan issue").requiredOption("--project <key>", "Project key (e.g. PROJ)", text).requiredOption("--summary <text>", "Test Plan summary (title)", text);
   textOrFileOption(cmd, "description", { description: "Test Plan description" });
   examples(cmd, [
     '--project PROJ --summary "Q3 regression plan"',
@@ -3351,7 +3481,7 @@ function deletePlan(parent) {
 }
 
 // src/commands/xray/plan/list.ts
-function list11(parent) {
+function list12(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. PROJ-574)", issueKey);
@@ -3411,7 +3541,7 @@ function registerPlanCommands(xray) {
   deletePlan(plan);
   add3(plan);
   remove3(plan);
-  list11(plan);
+  list12(plan);
 }
 
 // src/commands/xray/precondition/add.ts
@@ -3529,16 +3659,16 @@ 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 your project scheme."
-  ).requiredOption("--project <key>", "Project key (e.g. BD)", text).requiredOption("--summary <text>", "Pre-Condition summary (title)", text).addOption(
+    "Create a new Xray Pre-Condition issue. Note: the Pre-Condition issue type is only available in projects configured for it; it may not be on your project scheme."
+  ).requiredOption("--project <key>", "Project key (e.g. PROJ)", text).requiredOption("--summary <text>", "Pre-Condition summary (title)", text).addOption(
     new Option11("--type <type>", "Pre-Condition type").choices(["manual", "generic", "cucumber"]).default("manual")
   );
   textOrFileOption(cmd, "condition", { description: "Pre-condition body / definition text" });
   textOrFileOption(cmd, "description", { description: "Pre-Condition issue description" });
   examples(cmd, [
-    '--project BD --summary "User is logged in"',
-    '--project BD --summary "API key valid" --type generic --condition "apiKey != null"',
-    '--project BD --summary "Auth scenario" --type cucumber --condition "Given the user is authenticated"'
+    '--project PROJ --summary "User is logged in"',
+    '--project PROJ --summary "API key valid" --type generic --condition "apiKey != null"',
+    '--project PROJ --summary "Auth scenario" --type cucumber --condition "Given the user is authenticated"'
   ]);
   cmd.action(
     async (opts) => {
@@ -3578,7 +3708,7 @@ function deletePrecondition(parent) {
 }
 
 // src/commands/xray/precondition/list.ts
-function list12(parent) {
+function list13(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. PROJ-584)", issueKey);
@@ -3648,7 +3778,7 @@ function registerPreconditionCommands(xray) {
     "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"',
+    'create --project PROJ --summary "User is logged in"',
     "add PROJ-50 --test PROJ-1,PROJ-2",
     "list --test PROJ-584"
   ]);
@@ -3657,7 +3787,7 @@ function registerPreconditionCommands(xray) {
   deletePrecondition(precondition);
   add4(precondition);
   remove4(precondition);
-  list12(precondition);
+  list13(precondition);
 }
 
 // src/utils/xray/run-id.ts
@@ -3771,7 +3901,7 @@ function deleteEvidence(parent) {
 }
 
 // src/commands/xray/run/evidence/list.ts
-function list13(parent) {
+function list14(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 PROJ-1 --test PROJ-2"]);
   cmd.action(async (runId, opts) => {
@@ -3791,12 +3921,12 @@ function registerEvidenceCommands(run) {
     "delete 42 --evidence-id 7"
   ]);
   add6(evidence);
-  list13(evidence);
+  list14(evidence);
   deleteEvidence(evidence);
 }
 
 // src/commands/xray/run/field/get.ts
-function get4(parent) {
+function get8(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 PROJ-1 --test PROJ-2 --field-id customfield_10100"]);
   cmd.action(async (runId, opts) => {
@@ -3828,12 +3958,12 @@ function set(parent) {
 function registerRunFieldCommands(run) {
   const field = run.command("field").description("Get or set Xray custom field values on a test run");
   examples(field, ["get 42 --field-id customfield_10100", 'set 42 --field-id customfield_10100 --value "approved"']);
-  get4(field);
+  get8(field);
   set(field);
 }
 
 // src/commands/xray/run/get.ts
-function get5(parent) {
+function get9(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 PROJ-1 --test PROJ-2"]);
   cmd.action(async (runId, opts) => {
@@ -3845,7 +3975,7 @@ function get5(parent) {
 }
 
 // src/commands/xray/run/list.ts
-function list14(parent) {
+function list15(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 PROJ-1", "--execution PROJ-1 --limit 10", "--execution PROJ-1 --limit 10 --start 10"]);
   cmd.action(async (opts) => {
@@ -3858,7 +3988,7 @@ function list14(parent) {
 }
 
 // src/commands/xray/run/step/list.ts
-function list15(parent) {
+function list16(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 PROJ-1 --test PROJ-2"]);
   cmd.action(async (runId, opts) => {
@@ -3905,7 +4035,7 @@ function update10(parent) {
 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 PROJ-1 --test PROJ-2", "update 42 --step-id 1 --status PASS"]);
-  list15(step);
+  list16(step);
   update10(step);
 }
 
@@ -3951,8 +4081,8 @@ function registerRunCommands(xray) {
     "step list --execution PROJ-1 --test PROJ-2",
     "field get 42 --field-id customfield_10100"
   ]);
-  get5(run);
-  list14(run);
+  get9(run);
+  list15(run);
   update11(run);
   registerDefectCommands(run);
   registerEvidenceCommands(run);
@@ -3961,7 +4091,7 @@ function registerRunCommands(xray) {
 }
 
 // src/commands/xray/status/list.ts
-function list16(parent) {
+function list17(parent) {
   const cmd = parent.command("list").description("List configured Xray test (run) statuses").option("--step", "List test-step statuses instead of run statuses");
   examples(cmd, ["", ["--step", "step statuses"]]);
   cmd.action(async (opts) => {
@@ -3975,7 +4105,7 @@ function list16(parent) {
 function registerStatusCommands(xray) {
   const status = xray.command("status").description("Xray status discovery");
   examples(status, ["list", ["list --step", "step statuses"]]);
-  list16(status);
+  list17(status);
 }
 
 // src/commands/xray/step/add.ts
@@ -4012,7 +4142,7 @@ function deleteStep(parent) {
 }
 
 // src/commands/xray/step/list.ts
-function list17(parent) {
+function list18(parent) {
   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) => {
@@ -4055,7 +4185,7 @@ function registerStepCommands(xray) {
     "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 PROJ-584 --action "Open login" --result "Form shows"', "list --test PROJ-584"]);
-  list17(step);
+  list18(step);
   add7(step);
   update12(step);
   deleteStep(step);
@@ -4068,7 +4198,7 @@ var stepsSchema = z5.array(
   z5.object({ action: z5.string(), data: z5.string().optional(), result: z5.string().optional() })
 );
 function create11(parent) {
-  const cmd = parent.command("create").description("Create a new Xray Test issue").requiredOption("--project <key>", "Project key (e.g. AI)", text).requiredOption("--summary <text>", "Test summary (title)", text).addOption(
+  const cmd = parent.command("create").description("Create a new Xray Test issue").requiredOption("--project <key>", "Project key (e.g. PROJ)", text).requiredOption("--summary <text>", "Test summary (title)", text).addOption(
     new Option13("--type <type>", "Test type (when cucumber: also pass --gherkin; when generic: --definition)").choices(["manual", "cucumber", "generic"]).default("manual")
   ).addOption(
     new Option13("--cucumber-type <cucumberType>", "Cucumber scenario type (required when --type cucumber)").choices([
@@ -4156,7 +4286,7 @@ function deleteTest(parent) {
 }
 
 // src/commands/xray/test/get.ts
-function get6(parent) {
+function get10(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. PROJ-584)", listOf(issueKey));
   examples(cmd, ["PROJ-584", "PROJ-584 PROJ-585"]);
   cmd.action(async (testKeys) => {
@@ -4167,7 +4297,7 @@ function get6(parent) {
 }
 
 // src/commands/xray/test/list.ts
-function list18(parent) {
+function list19(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);
@@ -4309,11 +4439,11 @@ function update13(parent) {
 function registerTestCommands(xray) {
   const test = xray.command("test").description("Xray Test issue management (CRUD)");
   examples(test, ["get PROJ-584", 'create --project PROJ --summary "Login" --type manual']);
-  get6(test);
+  get10(test);
   create11(test);
   update13(test);
   deleteTest(test);
-  list18(test);
+  list19(test);
 }
 
 // src/commands/xray/testset/add.ts
@@ -4329,7 +4459,7 @@ function add8(parent) {
 
 // src/commands/xray/testset/create.ts
 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);
+  const cmd = parent.command("create").description("Create a new Xray Test Set issue").requiredOption("--project <key>", "Project key (e.g. PROJ)", text).requiredOption("--summary <text>", "Test Set summary (title)", text);
   textOrFileOption(cmd, "description", { description: "Test Set description" });
   examples(cmd, [
     '--project PROJ --summary "Smoke Test Set"',
@@ -4360,7 +4490,7 @@ function deleteTestset(parent) {
 }
 
 // src/commands/xray/testset/list.ts
-function list19(parent) {
+function list20(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. PROJ-584)", issueKey);
@@ -4407,7 +4537,7 @@ function registerTestsetCommands(xray) {
   deleteTestset(testset);
   add8(testset);
   remove6(testset);
-  list19(testset);
+  list20(testset);
 }
 
 // src/commands/xray/index.ts