jiradc-cli 1.0.30 → 1.0.32

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,
@@ -245,10 +263,55 @@ var TYPE_EXIT = {
   auth: EXIT.AUTH,
   rate_limited: EXIT.GENERIC,
   server: EXIT.GENERIC,
+  timeout: EXIT.GENERIC,
   network: EXIT.GENERIC,
   unknown: EXIT.GENERIC
 };
-var NETWORK_CODES = ["ENOTFOUND", "ECONNREFUSED", "ECONNRESET", "ETIMEDOUT"];
+var TRANSPORT_CODES = {
+  /** Our own timeout fired: connected (or tried to), no response in time. */
+  readTimeout: ["ECONNABORTED"],
+  /** The OS gave up establishing the connection. */
+  connectTimeout: ["ETIMEDOUT"],
+  /** No such host, or DNS itself is unavailable. */
+  unresolved: ["ENOTFOUND", "EAI_AGAIN"],
+  /** Host is there, nothing is listening on that port. */
+  refused: ["ECONNREFUSED"],
+  /** Established, then died mid-flight. */
+  dropped: ["ECONNRESET", "EPIPE"]
+};
+function humanMs(ms) {
+  return ms % 1e3 === 0 ? `${ms / 1e3}s` : `${ms}ms`;
+}
+function targetHost(err) {
+  const config = err?.config;
+  const raw = config?.baseURL ?? config?.url;
+  if (raw === void 0 || raw === "")
+    return void 0;
+  try {
+    return new URL(raw).host;
+  } catch {
+    return void 0;
+  }
+}
+function configuredTimeoutMs(err) {
+  const t = err?.config?.timeout;
+  return typeof t === "number" && t > 0 ? t : void 0;
+}
+function retryAfterSeconds(err) {
+  const headers = err?.response?.headers;
+  const raw = headers?.["retry-after"];
+  if (raw === void 0 || raw === "")
+    return void 0;
+  const seconds = Number(raw);
+  if (Number.isFinite(seconds))
+    return Math.max(0, Math.round(seconds));
+  if (typeof raw !== "string")
+    return void 0;
+  const at = Date.parse(raw);
+  if (Number.isNaN(at))
+    return void 0;
+  return Math.max(0, Math.round((at - Date.now()) / 1e3));
+}
 function httpStatus(err) {
   const e = err;
   return e?.response?.status ?? e?.statusCode;
@@ -285,9 +348,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 +371,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 +380,7 @@ function normalize(err, opts) {
         return {
           type: "auth",
           status,
-          message: "Authentication failed (HTTP 401)",
+          message: "Authentication failed",
           recovery: opts.authRecovery,
           retryable: false
         };
@@ -313,7 +388,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 +397,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,26 +406,29 @@ 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
         };
-      case 429:
+      case 429: {
+        const wait = retryAfterSeconds(err);
         return {
           type: "rate_limited",
           status,
-          message: "Rate limited (HTTP 429)",
-          recovery: "Wait and retry the request.",
-          retryable: true
+          message: `${opts.service} is rate limiting these requests`,
+          recovery: wait === void 0 ? `${opts.service} did not say how long to wait. Pause a few seconds before retrying, and make fewer requests at once.` : `${opts.service} asked for a ${wait}s pause before the next request. Wait at least that long, then retry.`,
+          retryable: true,
+          ...wait === void 0 ? {} : { detail: { retryAfterSeconds: wait } }
         };
+      }
     }
     if (status >= 500) {
       return {
         type: "server",
         status,
-        message: `Server error (HTTP ${status})`,
-        recovery: `${opts.service} returned an internal error; retry shortly.`,
+        message: status === 503 ? `${opts.service} returned 503 (service unavailable)` : `${opts.service} returned ${status}`,
+        recovery: status === 503 ? `${opts.service} is temporarily refusing work. Retry shortly.` : `${opts.service} failed to complete the request. Usually temporary, so retry. If it persists, the request itself may be at fault.`,
         retryable: true,
         detail
       };
@@ -365,15 +443,59 @@ function normalize(err, opts) {
     };
   }
   const code = errorCode(err);
-  if (code && NETWORK_CODES.includes(code) || NETWORK_CODES.some((c) => message.includes(c))) {
+  const transport = classifyTransport(err, code, message, opts);
+  if (transport)
+    return transport;
+  return { type: "unknown", message, recovery: "Unexpected error; inspect the message.", retryable: false };
+}
+function classifyTransport(err, code, message, opts) {
+  const matches = (codes) => code !== void 0 && codes.includes(code) || codes.some((c) => message.includes(c));
+  const host = targetHost(err);
+  const where = host ?? opts.service;
+  const urlVar = opts.urlEnvVar ?? "the base-URL environment variable";
+  if (matches(TRANSPORT_CODES.readTimeout)) {
+    const limit = configuredTimeoutMs(err);
+    return {
+      type: "timeout",
+      message: `${opts.service} did not respond${limit === void 0 ? " in time" : ` within ${humanMs(limit)}`}`,
+      recovery: `The request reached ${opts.service} but no response came back in time. Usually the server is busy or the query is too large. Retry, or ask for less: fewer results per page, fewer fields, a narrower query.`,
+      retryable: true
+    };
+  }
+  if (matches(TRANSPORT_CODES.connectTimeout)) {
+    const limit = configuredTimeoutMs(err);
+    return {
+      type: "timeout",
+      message: `Could not open a connection to ${where}${limit === void 0 ? "" : ` within ${humanMs(limit)}`}`,
+      recovery: `The host did not accept a connection in time. If it is reachable at all it is likely overloaded, so retry. If this repeats, confirm ${urlVar} points at a host this machine can reach.`,
+      retryable: true
+    };
+  }
+  if (matches(TRANSPORT_CODES.unresolved)) {
+    return {
+      type: "network",
+      message: `The host ${where} does not resolve`,
+      recovery: `${urlVar} points at a hostname that cannot be looked up from this machine. Check it for a typo. Retrying will not help until it changes.`,
+      retryable: false
+    };
+  }
+  if (matches(TRANSPORT_CODES.refused)) {
+    return {
+      type: "network",
+      message: `Nothing accepted a connection at ${where}`,
+      recovery: `The host resolved but refused the connection, usually a wrong port or a service that is not running. Retrying will not help until that changes.`,
+      retryable: false
+    };
+  }
+  if (matches(TRANSPORT_CODES.dropped)) {
     return {
       type: "network",
-      message: `Cannot connect to ${opts.service}: ${message}`,
-      recovery: opts.networkRecovery ?? "Verify the *_URL is correct, the server is reachable, and you are on the VPN if required.",
+      message: `The connection to ${opts.service} closed before a response arrived`,
+      recovery: `The connection dropped mid-request. This is usually a blip, so retry.`,
       retryable: true
     };
   }
-  return { type: "unknown", message, recovery: "Unexpected error; inspect the message.", retryable: false };
+  return void 0;
 }
 function classifyError(err, opts) {
   const base = normalize(err, opts);
@@ -410,8 +532,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 +1106,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 +1162,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 +1209,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 +1881,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) => {
@@ -2411,16 +2555,16 @@ function assertAtLeastOne(opts, keys) {
 
 // src/commands/xray/execution/add.ts
 function add(parent) {
-  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. AI-200)", issueKey).option("--test <keys>", "Comma-separated test issue keys to add (e.g. AI-1,AI-2)", keyList).option(
+  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. AI-300)",
+    "Comma-separated Test Set keys; each set's current tests are added to the execution (e.g. PROJ-300)",
     keyList
   );
   examples(cmd, [
-    "AI-200 --test AI-1",
-    "AI-200 --test AI-1,AI-2",
-    "AI-200 --set AI-300",
-    "AI-200 --test AI-1 --set AI-300"
+    "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) => {
     assertAtLeastOne(opts, ["test", "set"]);
@@ -2477,8 +2621,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 });
@@ -2495,8 +2639,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);
@@ -2508,8 +2652,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 });
@@ -2519,8 +2663,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 });
@@ -2530,9 +2674,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();
@@ -2547,9 +2691,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);
@@ -2564,7 +2708,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({
@@ -2602,8 +2746,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({
@@ -2619,9 +2763,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();
@@ -2637,7 +2781,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 });
@@ -2648,7 +2792,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 });
@@ -2658,8 +2802,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({
@@ -2675,9 +2819,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) {
@@ -2699,7 +2843,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);
@@ -2730,8 +2874,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(
@@ -2766,7 +2910,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);
@@ -2789,8 +2933,12 @@ function registerImportCommands(xray) {
 
 // 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();
@@ -2807,8 +2955,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 });
@@ -2825,8 +2973,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);
@@ -2838,8 +2986,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 });
@@ -2849,8 +2997,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();
@@ -2864,9 +3016,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();
@@ -2881,10 +3033,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);
@@ -2896,8 +3048,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 });
@@ -3005,7 +3157,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")
   );
@@ -3044,8 +3196,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);
@@ -3057,8 +3209,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 });
@@ -3068,8 +3220,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 });
@@ -3080,10 +3232,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 });
@@ -3121,12 +3273,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);
@@ -3148,7 +3300,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 });
@@ -3160,7 +3312,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 });
@@ -3194,7 +3346,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);
 }
@@ -3220,7 +3372,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 });
@@ -3236,7 +3388,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 });
@@ -3248,7 +3400,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 });
@@ -3261,7 +3413,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"
   ]);
@@ -3273,7 +3425,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 });
@@ -3287,7 +3439,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) => {
@@ -3310,7 +3462,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 });
@@ -3322,7 +3474,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 });
@@ -3335,7 +3487,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 });
@@ -3355,7 +3507,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(
@@ -3379,7 +3531,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);
 }
@@ -3390,8 +3542,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) => {
@@ -3418,12 +3570,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);
@@ -3455,13 +3607,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) => {
@@ -3477,8 +3629,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 });
@@ -3488,8 +3640,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 });
@@ -3499,13 +3651,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) => {
@@ -3529,7 +3681,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);
@@ -3556,15 +3708,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"
     ]
   ]);
@@ -3621,8 +3773,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 });
@@ -3632,8 +3784,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 });
@@ -3646,7 +3798,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();
@@ -3718,7 +3870,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"
@@ -3728,8 +3880,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) => {
@@ -3783,7 +3935,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);
@@ -3793,8 +3945,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 });
@@ -3807,8 +3959,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 });
@@ -3825,8 +3977,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);
@@ -3838,8 +3990,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 });
@@ -3849,8 +4001,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 });
@@ -3860,9 +4012,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();
@@ -3876,7 +4028,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);
@@ -3888,7 +4040,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);
@@ -3973,5 +4125,5 @@ await runCli(buildProgram(), {
   credentialInfo: getCredentialInfo,
   service: "Jira",
   authRecovery: "Set the JIRA_URL and JIRA_TOKEN environment variables.",
-  networkRecovery: "Verify JIRA_URL is correct, the server is reachable, and you are on the VPN if required."
+  urlEnvVar: "JIRA_URL"
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jiradc-cli",
-  "version": "1.0.30",
+  "version": "1.0.32",
   "publish": true,
   "type": "module",
   "main": "dist/index.js",
@@ -13,7 +13,7 @@
   "dependencies": {
     "commander": "^13.1.0",
     "zod": "^3.25.67",
-    "jira-data-center-client": "1.0.41"
+    "jira-data-center-client": "1.0.42"
   },
   "devDependencies": {
     "@types/node": "24.10.4",
@@ -32,6 +32,8 @@
   },
   "scripts": {
     "build": "tsup",
+    "check-types": "tsc --noEmit -p tsconfig.json",
+    "clean": "rm -rf dist",
     "dev": "tsx src/index.ts",
     "lint": "eslint src tests",
     "lint:fix": "eslint src tests --fix",