bitbucketdc-cli 1.0.12 → 1.0.14

package/dist/index.js

@@ -1,8 +1,40 @@
 #!/usr/bin/env node
 
 // src/index.ts
+import { readFileSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
 import { styleText } from "util";
-import { Command as Command8 } from "commander";
+import { Command as Command9 } from "commander";
+
+// src/utils/cli.ts
+import { InvalidArgumentError } from "commander";
+function intInRange(min, max) {
+  return (raw) => {
+    const n = parseInt(raw, 10);
+    if (Number.isNaN(n) || !Number.isFinite(n)) {
+      throw new InvalidArgumentError(`Not a number: "${raw}"`);
+    }
+    if (n < min || n > max) {
+      throw new InvalidArgumentError(`Must be between ${min} and ${max} (got ${n})`);
+    }
+    return n;
+  };
+}
+function nonNegativeInt(raw) {
+  const n = parseInt(raw, 10);
+  if (Number.isNaN(n) || n < 0) {
+    throw new InvalidArgumentError(`Must be a non-negative integer (got "${raw}")`);
+  }
+  return n;
+}
+function positiveInt(raw) {
+  const n = parseInt(raw, 10);
+  if (Number.isNaN(n) || n < 1) {
+    throw new InvalidArgumentError(`Must be a positive integer (got "${raw}")`);
+  }
+  return n;
+}
 
 // src/utils/client.ts
 import { BitbucketClient } from "bitbucket-data-center-client";
@@ -131,15 +163,23 @@ function handleError(err) {
 `
     );
   } else {
-    process.stderr.write(`${JSON.stringify({ error: message })}
-`);
+    const responseData = err?.response?.data;
+    const detail = responseData && typeof responseData === "object" ? responseData : void 0;
+    process.stderr.write(
+      `${JSON.stringify({
+        error: message,
+        ...axiosStatus !== void 0 && { statusCode: axiosStatus },
+        ...detail && { detail }
+      })}
+`
+    );
   }
   process.exit(1);
 }
 
 // src/commands/commit/changes.ts
 function changes(parent) {
-  parent.command("changes").description("List files changed in a specific commit").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--commit <hash>", "Commit hash").option("--limit <n>", "Number of items to return (default: 25)", parseInt).option("--start <n>", "Start index for pagination (default: 0)", parseInt).addHelpText(
+  parent.command("changes").description("List files changed in a specific commit").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--commit <hash>", "Commit hash").option("--limit <n>", "Number of items to return (1-1000)", intInRange(1, 1e3), 25).option("--start <n>", "Start index for pagination", nonNegativeInt).addHelpText(
     "after",
     `
 Examples:
@@ -160,8 +200,10 @@ Examples:
 
 // src/commands/commit/diff.ts
 import { Option } from "commander";
+var WHITESPACE_MODES = ["show", "ignore-all"];
+var DIFF_FORMATS = ["text", "json"];
 function diff(parent) {
-  parent.command("diff").description("Get diff for a specific commit").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--commit <hash>", "Commit hash").option("--path <path>", "Scope diff to a single file").option("--context <n>", "Number of context lines around changes", parseInt).addOption(new Option("--whitespace <mode>", "Whitespace handling").choices(["show", "ignore-all"])).addOption(new Option("--format <fmt>", "Response format (default: text)").choices(["text", "json"])).addHelpText(
+  parent.command("diff").description("Get diff for a specific commit").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--commit <hash>", "Commit hash").option("--path <path>", "Scope diff to a single file").option("--context <n>", "Number of context lines around changes (0-500)", intInRange(0, 500)).addOption(new Option("--whitespace <mode>", "Whitespace handling").choices(WHITESPACE_MODES)).addOption(new Option("--format <fmt>", "Response format").choices(DIFF_FORMATS).default("text")).addHelpText(
     "after",
     `
 Examples:
@@ -178,7 +220,7 @@ Examples:
         path: opts.path,
         contextLines: opts.context,
         whitespace: opts.whitespace,
-        format: opts.format || "text"
+        format: opts.format
       });
       if (typeof result === "string") {
         process.stdout.write(result);
@@ -206,7 +248,7 @@ Examples:
 
 // src/commands/compare/changes.ts
 function changes2(parent) {
-  parent.command("changes").description("List files that differ between two refs").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--from <ref>", "Source ref (branch, tag, or commit)").requiredOption("--to <ref>", "Target ref (branch, tag, or commit)").option("--limit <n>", "Number of items to return (default: 25)", parseInt).option("--start <n>", "Start index for pagination (default: 0)", parseInt).addHelpText(
+  parent.command("changes").description("List files that differ between two refs").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--from <ref>", "Source ref (branch, tag, or commit)").requiredOption("--to <ref>", "Target ref (branch, tag, or commit)").option("--limit <n>", "Number of items to return (1-1000)", intInRange(1, 1e3), 25).option("--start <n>", "Start index for pagination", nonNegativeInt).addHelpText(
     "after",
     `
 Examples:
@@ -231,8 +273,9 @@ Examples:
 
 // src/commands/compare/diff.ts
 import { Option as Option2 } from "commander";
+var WHITESPACE_MODES2 = ["show", "ignore-all"];
 function diff2(parent) {
-  parent.command("diff").description("Get diff between two refs (structured JSON)").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--from <ref>", "Source ref (branch, tag, or commit)").requiredOption("--to <ref>", "Target ref (branch, tag, or commit)").option("--path <path>", "Scope diff to a single file").option("--context <n>", "Number of context lines around changes", parseInt).addOption(new Option2("--whitespace <mode>", "Whitespace handling").choices(["show", "ignore-all"])).addHelpText(
+  parent.command("diff").description("Get diff between two refs (structured JSON)").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--from <ref>", "Source ref (branch, tag, or commit)").requiredOption("--to <ref>", "Target ref (branch, tag, or commit)").option("--path <path>", "Scope diff to a single file").option("--context <n>", "Number of context lines around changes (0-500)", intInRange(0, 500)).addOption(new Option2("--whitespace <mode>", "Whitespace handling").choices(WHITESPACE_MODES2)).addHelpText(
     "after",
     `
 Examples:
@@ -272,7 +315,7 @@ Examples:
 
 // src/commands/file/list.ts
 function list(parent) {
-  parent.command("list").description("List directory contents in a repository").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").option("--path <path>", "Directory path (defaults to root)").option("--at <ref>", "Branch, tag, or commit hash").option("--limit <n>", "Number of items to return (default: 500)", parseInt).option("--start <n>", "Start index for pagination (default: 0)", parseInt).addHelpText(
+  parent.command("list").description("List directory contents in a repository").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").option("--path <path>", "Directory path (defaults to root)").option("--at <ref>", "Branch, tag, or commit hash").option("--branch <ref>", "Alias for --at").option("--limit <n>", "Number of items to return (1-1000)", intInRange(1, 1e3), 25).option("--start <n>", "Start index for pagination", nonNegativeInt).addHelpText(
     "after",
     `
 Examples:
@@ -282,11 +325,12 @@ Examples:
   ).action(
     async (opts) => {
       const client = getClient();
+      const ref = opts.at ?? opts.branch;
       const result = await client.repositories.browse({
         projectKey: opts.project,
         repositorySlug: opts.repo,
         path: opts.path,
-        at: opts.at,
+        at: ref,
         limit: opts.limit,
         start: opts.start
       });
@@ -297,7 +341,7 @@ Examples:
 
 // src/commands/file/show.ts
 function show(parent) {
-  parent.command("show").description("Show raw file content from a repository").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--path <path>", "File path").option("--at <ref>", "Branch, tag, or commit hash").addHelpText(
+  parent.command("show").description("Show raw file content from a repository").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--path <path>", "File path").option("--at <ref>", "Branch, tag, or commit hash").option("--branch <ref>", "Alias for --at").addHelpText(
     "after",
     `
 Examples:
@@ -305,11 +349,12 @@ Examples:
   bitbucketdc file show --project PROJ --repo my-app --path config/settings.yaml --at release/2.0`
   ).action(async (opts) => {
     const client = getClient();
+    const ref = opts.at ?? opts.branch;
     const result = await client.repositories.getRawContent({
       projectKey: opts.project,
       repositorySlug: opts.repo,
       path: opts.path,
-      at: opts.at
+      at: ref
     });
     process.stdout.write(result);
   });
@@ -332,10 +377,10 @@ Examples:
 
 // src/commands/pr/activities.ts
 function activities(parent) {
-  parent.command("activities").description("Get activity on a pull request (comments, approvals, merges, etc.)").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID").option(
+  parent.command("activities").description("Get activity on a pull request (comments, approvals, merges, etc.)").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID", positiveInt).option(
     "--types <types>",
     "Comma-separated activity types (APPROVED, COMMENTED, DECLINED, MERGED, OPENED, REOPENED, RESCOPED, REVIEW_COMMENTED, REVIEW_DISCARDED, REVIEW_FINISHED, REVIEWED, UNAPPROVED, UPDATED)"
-  ).option("--start <n>", "Starting index for pagination (default: 0)", parseInt).option("--limit <n>", "Maximum number of items to return (default: 25)", parseInt).addHelpText(
+  ).option("--start <n>", "Starting index for pagination", nonNegativeInt).option("--limit <n>", "Maximum number of items to return (1-1000)", intInRange(1, 1e3), 25).addHelpText(
     "after",
     `
 Examples:
@@ -348,7 +393,7 @@ Examples:
       const result = await client.pullRequests.getActivities({
         projectKey: opts.project,
         repositorySlug: opts.repo,
-        pullRequestId: parseInt(opts.id),
+        pullRequestId: opts.id,
         start: opts.start,
         limit: opts.limit
       });
@@ -365,7 +410,7 @@ Examples:
 
 // src/commands/pr/can-merge.ts
 function canMerge(parent) {
-  parent.command("can-merge").description("Check if a pull request can be merged").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID", parseInt).addHelpText("after", "\nExamples:\n  bitbucketdc pr can-merge --project PROJ --repo my-repo --id 42").action(async (opts) => {
+  parent.command("can-merge").description("Check if a pull request can be merged").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID", positiveInt).addHelpText("after", "\nExamples:\n  bitbucketdc pr can-merge --project PROJ --repo my-repo --id 42").action(async (opts) => {
     const client = getClient();
     const result = await client.pullRequests.canMerge({
       projectKey: opts.project,
@@ -378,7 +423,7 @@ function canMerge(parent) {
 
 // src/commands/pr/changes.ts
 function changes3(parent) {
-  parent.command("changes").description("List changed files in a pull request").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID").option("--limit <n>", "Number of items to return (default: 25)", parseInt).addHelpText(
+  parent.command("changes").description("List changed files in a pull request").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID", positiveInt).option("--limit <n>", "Number of items to return (1-1000)", intInRange(1, 1e3), 25).addHelpText(
     "after",
     "\nExamples:\n  bitbucketdc pr changes --project PROJ --repo my-repo --id 42\n  bitbucketdc pr changes --project PROJ --repo my-repo --id 42 --limit 100"
   ).action(async (opts) => {
@@ -386,7 +431,7 @@ function changes3(parent) {
     const result = await client.pullRequests.getChanges({
       projectKey: opts.project,
       repositorySlug: opts.repo,
-      pullRequestId: parseInt(opts.id),
+      pullRequestId: opts.id,
       limit: opts.limit
     });
     output(result);
@@ -395,7 +440,7 @@ function changes3(parent) {
 
 // src/commands/pr/comment.ts
 function comment(parent) {
-  parent.command("comment").description("Add a general comment to a pull request").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID").requiredOption("--text <text>", "Comment text").option("--parent <n>", "Parent comment ID to reply to").addHelpText(
+  parent.command("comment").description("Add a general comment to a pull request").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID", positiveInt).requiredOption("--text <text>", "Comment text").option("--parent <n>", "Parent comment ID to reply to", positiveInt).addHelpText(
     "after",
     `
 Examples:
@@ -406,9 +451,9 @@ Examples:
     const result = await client.pullRequests.addComment({
       projectKey: opts.project,
       repositorySlug: opts.repo,
-      pullRequestId: parseInt(opts.id),
+      pullRequestId: opts.id,
       text: opts.text,
-      parentId: opts.parent ? parseInt(opts.parent) : void 0
+      parentId: opts.parent
     });
     outputCommentResult(result);
   });
@@ -458,7 +503,7 @@ Examples:
 
 // src/commands/pr/decline.ts
 function decline(parent) {
-  parent.command("decline").description("Decline a pull request").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID", parseInt).addHelpText("after", "\nExamples:\n  bitbucketdc pr decline --project PROJ --repo my-repo --id 42").action(async (opts) => {
+  parent.command("decline").description("Decline a pull request").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID", positiveInt).addHelpText("after", "\nExamples:\n  bitbucketdc pr decline --project PROJ --repo my-repo --id 42").action(async (opts) => {
     const client = getClient();
     const result = await client.pullRequests.decline({
       projectKey: opts.project,
@@ -471,7 +516,7 @@ function decline(parent) {
 
 // src/commands/pr/delete-comment.ts
 function deleteComment(parent) {
-  parent.command("delete-comment").description("Delete a pull request comment").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID", parseInt).requiredOption("--comment-id <n>", "Comment ID to delete", parseInt).addHelpText(
+  parent.command("delete-comment").description("Delete a pull request comment").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID", positiveInt).requiredOption("--comment-id <n>", "Comment ID to delete", positiveInt).addHelpText(
     "after",
     "\nExamples:\n  bitbucketdc pr delete-comment --project PROJ --repo my-repo --id 42 --comment-id 123"
   ).action(async (opts) => {
@@ -495,7 +540,7 @@ function deleteComment(parent) {
 
 // src/commands/pr/delete.ts
 function deletePr(parent) {
-  parent.command("delete").description("Delete a pull request").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID", parseInt).addHelpText("after", "\nExamples:\n  bitbucketdc pr delete --project PROJ --repo my-repo --id 42").action(async (opts) => {
+  parent.command("delete").description("Delete a pull request").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID", positiveInt).addHelpText("after", "\nExamples:\n  bitbucketdc pr delete --project PROJ --repo my-repo --id 42").action(async (opts) => {
     const client = getClient();
     await client.pullRequests.deletePullRequest({
       projectKey: opts.project,
@@ -508,8 +553,10 @@ function deletePr(parent) {
 
 // src/commands/pr/diff.ts
 import { Option as Option3 } from "commander";
+var WHITESPACE_MODES3 = ["show", "ignore-all"];
+var DIFF_FORMATS2 = ["text", "json"];
 function diff3(parent) {
-  parent.command("diff").description("Get diff for a pull request").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID").option("--path <path>", "File path (omit for full PR diff)").option("--since <hash>", "Since commit hash").option("--until <hash>", "Until commit hash").option("--context <n>", "Number of context lines around changes (default: 10)", parseInt).addOption(new Option3("--whitespace <mode>", "Whitespace handling (default: show)").choices(["show", "ignore-all"])).addOption(new Option3("--format <fmt>", "Response format (default: text)").choices(["text", "json"])).addHelpText(
+  parent.command("diff").description("Get diff for a pull request").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID", positiveInt).option("--path <path>", "File path (omit for full PR diff)").option("--since <hash>", "Since commit hash").option("--until <hash>", "Until commit hash").option("--context <n>", "Number of context lines around changes (0-500)", intInRange(0, 500), 10).addOption(new Option3("--whitespace <mode>", "Whitespace handling").choices(WHITESPACE_MODES3).default("show")).addOption(new Option3("--format <fmt>", "Response format").choices(DIFF_FORMATS2).default("text")).addHelpText(
     "after",
     `
 Examples:
@@ -523,13 +570,13 @@ Examples:
       const result = await client.pullRequests.getDiff({
         projectKey: opts.project,
         repositorySlug: opts.repo,
-        pullRequestId: parseInt(opts.id),
+        pullRequestId: opts.id,
         path: opts.path,
         sinceId: opts.since,
         untilId: opts.until,
         contextLines: opts.context,
         whitespace: opts.whitespace,
-        format: opts.format || "text"
+        format: opts.format
       });
       if (typeof result === "string") {
         process.stdout.write(result);
@@ -542,7 +589,7 @@ Examples:
 
 // src/commands/pr/edit-comment.ts
 function editComment(parent) {
-  parent.command("edit-comment").description("Edit a pull request comment").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID", parseInt).requiredOption("--comment-id <n>", "Comment ID to edit", parseInt).requiredOption("--text <content>", "New comment text").addHelpText(
+  parent.command("edit-comment").description("Edit a pull request comment").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID", positiveInt).requiredOption("--comment-id <n>", "Comment ID to edit", positiveInt).requiredOption("--text <content>", "New comment text").addHelpText(
     "after",
     '\nExamples:\n  bitbucketdc pr edit-comment --project PROJ --repo my-repo --id 42 --comment-id 123 --text "Updated text"'
   ).action(async (opts) => {
@@ -567,7 +614,7 @@ function editComment(parent) {
 
 // src/commands/pr/file-comment.ts
 function fileComment(parent) {
-  parent.command("file-comment").description("Add a file-level comment to a pull request").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID").requiredOption("--text <text>", "Comment text").requiredOption("--path <path>", "File path to attach comment to (e.g., src/main.ts)").addHelpText(
+  parent.command("file-comment").description("Add a file-level comment to a pull request").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID", positiveInt).requiredOption("--text <text>", "Comment text").requiredOption("--path <path>", "File path to attach comment to (e.g., src/main.ts)").addHelpText(
     "after",
     '\nExamples:\n  bitbucketdc pr file-comment --project PROJ --repo my-repo --id 42 --text "This file needs refactoring" --path src/main.ts'
   ).action(async (opts) => {
@@ -575,7 +622,7 @@ function fileComment(parent) {
     const result = await client.pullRequests.addComment({
       projectKey: opts.project,
       repositorySlug: opts.repo,
-      pullRequestId: parseInt(opts.id),
+      pullRequestId: opts.id,
       text: opts.text,
       path: opts.path
     });
@@ -585,7 +632,7 @@ function fileComment(parent) {
 
 // src/commands/pr/file-diff.ts
 function fileDiff(parent) {
-  parent.command("file-diff").description("Get structured line-by-line diff for a specific file").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID").requiredOption("--path <path>", "File path (e.g., src/main.ts)").option("--context <n>", "Number of context lines around changes (default: 10)", parseInt).addHelpText(
+  parent.command("file-diff").description("Get structured line-by-line diff for a specific file").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID", positiveInt).requiredOption("--path <path>", "File path (e.g., src/main.ts)").option("--context <n>", "Number of context lines around changes (0-500)", intInRange(0, 500), 10).addHelpText(
     "after",
     "\nExamples:\n  bitbucketdc pr file-diff --project PROJ --repo my-repo --id 42 --path src/main.ts\n  bitbucketdc pr file-diff --project PROJ --repo my-repo --id 42 --path src/main.ts --context 5"
   ).action(async (opts) => {
@@ -593,7 +640,7 @@ function fileDiff(parent) {
     const result = await client.pullRequests.getFileDiff({
       projectKey: opts.project,
       repositorySlug: opts.repo,
-      pullRequestId: parseInt(opts.id),
+      pullRequestId: opts.id,
       path: opts.path,
       contextLines: opts.context
     });
@@ -603,12 +650,12 @@ function fileDiff(parent) {
 
 // src/commands/pr/get.ts
 function get(parent) {
-  parent.command("get").description("Get pull request details").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID").addHelpText("after", "\nExamples:\n  bitbucketdc pr get --project PROJ --repo my-repo --id 42").action(async (opts) => {
+  parent.command("get").description("Get pull request details").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID", positiveInt).addHelpText("after", "\nExamples:\n  bitbucketdc pr get --project PROJ --repo my-repo --id 42").action(async (opts) => {
     const client = getClient();
     const result = await client.pullRequests.get({
       projectKey: opts.project,
       repositorySlug: opts.repo,
-      pullRequestId: parseInt(opts.id)
+      pullRequestId: opts.id
     });
     output(result);
   });
@@ -616,7 +663,7 @@ function get(parent) {
 
 // src/commands/pr/inbox.ts
 function inbox(parent) {
-  parent.command("inbox").description("List pull requests in your reviewer inbox").option("--start <n>", "Starting index for pagination (default: 0)", parseInt).option("--limit <n>", "Maximum number of pull requests to return (default: 25)", parseInt).addHelpText(
+  parent.command("inbox").description("List pull requests in your reviewer inbox").option("--start <n>", "Starting index for pagination", nonNegativeInt).option("--limit <n>", "Maximum number of pull requests to return (1-1000)", intInRange(1, 1e3), 25).addHelpText(
     "after",
     "\nExamples:\n  bitbucketdc pr inbox\n  bitbucketdc pr inbox --limit 10\n  bitbucketdc pr inbox --start 25 --limit 25"
   ).action(async (opts) => {
@@ -631,11 +678,11 @@ function inbox(parent) {
 
 // src/commands/pr/line-comment.ts
 import { Option as Option4 } from "commander";
+var LINE_TYPES = ["ADDED", "REMOVED", "CONTEXT"];
+var FILE_TYPES = ["FROM", "TO"];
 function lineComment(parent) {
-  parent.command("line-comment").description("Add an inline comment to a specific line in a pull request").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID").requiredOption("--text <text>", "Comment text").requiredOption("--path <path>", "File path (e.g., src/main.ts)").requiredOption("--line <n>", "Line number to comment on").addOption(
-    new Option4("--line-type <type>", "Type of line").choices(["ADDED", "REMOVED", "CONTEXT"]).makeOptionMandatory()
-  ).addOption(
-    new Option4("--file-type <type>", "Side of diff: FROM (source/old) or TO (destination/new)").choices(["FROM", "TO"]).makeOptionMandatory()
+  parent.command("line-comment").description("Add an inline comment to a specific line in a pull request").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID", positiveInt).requiredOption("--text <text>", "Comment text").requiredOption("--path <path>", "File path (e.g., src/main.ts)").requiredOption("--line <n>", "Line number to comment on", positiveInt).addOption(new Option4("--line-type <type>", "Type of line").choices(LINE_TYPES).makeOptionMandatory()).addOption(
+    new Option4("--file-type <type>", "Side of diff: FROM (source/old) or TO (destination/new)").choices(FILE_TYPES).makeOptionMandatory()
   ).addHelpText(
     "after",
     `
@@ -648,10 +695,10 @@ Examples:
       const result = await client.pullRequests.addComment({
         projectKey: opts.project,
         repositorySlug: opts.repo,
-        pullRequestId: parseInt(opts.id),
+        pullRequestId: opts.id,
         text: opts.text,
         path: opts.path,
-        line: parseInt(opts.line),
+        line: opts.line,
         lineType: opts.lineType,
         fileType: opts.fileType
       });
@@ -662,7 +709,7 @@ Examples:
 
 // src/commands/pr/merge.ts
 function merge(parent) {
-  parent.command("merge").description("Merge a pull request").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID", parseInt).option("--strategy <id>", "Merge strategy (e.g., squash, no-ff, ff, ff-only, rebase-no-ff, rebase-ff-only)").option("--message <text>", "Custom merge commit message").addHelpText(
+  parent.command("merge").description("Merge a pull request").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID", positiveInt).option("--strategy <id>", "Merge strategy (e.g., squash, no-ff, ff, ff-only, rebase-no-ff, rebase-ff-only)").option("--message <text>", "Custom merge commit message").addHelpText(
     "after",
     `
 Examples:
@@ -685,7 +732,7 @@ Examples:
 // src/commands/pr/reaction-add.ts
 import { Option as Option5 } from "commander";
 function reactionAdd(parent) {
-  parent.command("reaction-add").description("Add an emoticon reaction to a PR comment").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID").requiredOption("--comment-id <n>", "Comment ID").addOption(
+  parent.command("reaction-add").description("Add an emoticon reaction to a PR comment").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID", positiveInt).requiredOption("--comment-id <n>", "Comment ID", positiveInt).addOption(
     new Option5("--emoticon <name>", "Emoticon to react with").choices(["thumbsup", "thumbsdown", "heart", "thinking_face", "laughing"]).makeOptionMandatory()
   ).addHelpText(
     "after",
@@ -693,48 +740,51 @@ function reactionAdd(parent) {
 Examples:
   bitbucketdc pr reaction-add --project PROJ --repo my-repo --id 42 --comment-id 123 --emoticon thumbsup
   bitbucketdc pr reaction-add --project PROJ --repo my-repo --id 42 --comment-id 123 --emoticon heart`
-  ).action(async (opts) => {
-    const client = getClient();
-    const result = await client.pullRequests.addReaction({
-      projectKey: opts.project,
-      repositorySlug: opts.repo,
-      pullRequestId: parseInt(opts.id),
-      commentId: parseInt(opts.commentId),
-      emoticon: opts.emoticon
-    });
-    output(result);
-  });
+  ).action(
+    async (opts) => {
+      const client = getClient();
+      const result = await client.pullRequests.addReaction({
+        projectKey: opts.project,
+        repositorySlug: opts.repo,
+        pullRequestId: opts.id,
+        commentId: opts.commentId,
+        emoticon: opts.emoticon
+      });
+      output(result);
+    }
+  );
 }
 
 // src/commands/pr/reaction-remove.ts
 import { Option as Option6 } from "commander";
 function reactionRemove(parent) {
-  parent.command("reaction-remove").description("Remove an emoticon reaction from a PR comment").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID").requiredOption("--comment-id <n>", "Comment ID").addOption(
+  parent.command("reaction-remove").description("Remove an emoticon reaction from a PR comment").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID", positiveInt).requiredOption("--comment-id <n>", "Comment ID", positiveInt).addOption(
     new Option6("--emoticon <name>", "Emoticon to remove").choices(["thumbsup", "thumbsdown", "heart", "thinking_face", "laughing"]).makeOptionMandatory()
   ).addHelpText(
     "after",
     `
 Examples:
   bitbucketdc pr reaction-remove --project PROJ --repo my-repo --id 42 --comment-id 123 --emoticon thumbsup`
-  ).action(async (opts) => {
-    const client = getClient();
-    await client.pullRequests.removeReaction({
-      projectKey: opts.project,
-      repositorySlug: opts.repo,
-      pullRequestId: parseInt(opts.id),
-      commentId: parseInt(opts.commentId),
-      emoticon: opts.emoticon
-    });
-    output({ removed: true, emoticon: opts.emoticon });
-  });
+  ).action(
+    async (opts) => {
+      const client = getClient();
+      await client.pullRequests.removeReaction({
+        projectKey: opts.project,
+        repositorySlug: opts.repo,
+        pullRequestId: opts.id,
+        commentId: opts.commentId,
+        emoticon: opts.emoticon
+      });
+      output({ removed: true, emoticon: opts.emoticon });
+    }
+  );
 }
 
 // src/commands/pr/review.ts
 import { Option as Option7 } from "commander";
+var REVIEW_STATUSES = ["APPROVED", "NEEDS_WORK", "UNAPPROVED"];
 function review(parent) {
-  parent.command("review").description("Update review status for a pull request").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID").addOption(
-    new Option7("--status <status>", "Review status").choices(["APPROVED", "NEEDS_WORK", "UNAPPROVED"]).makeOptionMandatory()
-  ).addHelpText(
+  parent.command("review").description("Update review status for a pull request").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID", positiveInt).addOption(new Option7("--status <status>", "Review status").choices(REVIEW_STATUSES).makeOptionMandatory()).addHelpText(
     "after",
     `
 Examples:
@@ -746,7 +796,7 @@ Examples:
     const result = await client.pullRequests.updateReviewStatus({
       projectKey: opts.project,
       repositorySlug: opts.repo,
-      pullRequestId: parseInt(opts.id),
+      pullRequestId: opts.id,
       status: opts.status
     });
     output(result);
@@ -755,7 +805,7 @@ Examples:
 
 // src/commands/pr/update.ts
 function update(parent) {
-  parent.command("update").description("Update a pull request title and/or description").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID", parseInt).option("--title <title>", "New pull request title").option("--description <text>", "New pull request description").addHelpText(
+  parent.command("update").description("Update a pull request title and/or description").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID", positiveInt).option("--title <title>", "New pull request title").option("--description <text>", "New pull request description").addHelpText(
     "after",
     `
 Examples:
@@ -824,7 +874,7 @@ Examples:
 
 // src/commands/project/list.ts
 function list2(parent) {
-  parent.command("list").description("List projects").option("--name <name>", "Filter projects by name (partial match)").option("--permission <permission>", "Filter by permission (e.g., PROJECT_READ, PROJECT_WRITE, PROJECT_ADMIN)").option("--start <start>", "Starting index for pagination", parseInt).option("--limit <limit>", "Maximum number of projects to return", parseInt).addHelpText(
+  parent.command("list").description("List projects").option("--name <name>", "Filter projects by name (partial match)").option("--permission <permission>", "Filter by permission (e.g., PROJECT_READ, PROJECT_WRITE, PROJECT_ADMIN)").option("--start <start>", "Starting index for pagination", nonNegativeInt).option("--limit <limit>", "Maximum number of projects to return (1-1000)", intInRange(1, 1e3), 25).addHelpText(
     "after",
     '\nExamples:\n  bitbucketdc project list\n  bitbucketdc project list --name "My Project"\n  bitbucketdc project list --permission PROJECT_READ --limit 10'
   ).action(async (opts) => {
@@ -877,20 +927,22 @@ function upload(parent) {
   ).action(async (opts) => {
     const client = getClient();
     const filePaths = opts.files.split(",").map((p) => p.trim()).filter(Boolean);
-    const results = [];
-    const failed = [];
-    for (const filePath of filePaths) {
-      try {
-        const result = await client.repositories.uploadAttachment({
-          projectKey: opts.project,
-          repositorySlug: opts.repo,
-          filePath
-        });
-        results.push({ id: result.id, url: result.url });
-      } catch (err) {
-        failed.push({ filePath, error: err instanceof Error ? err.message : String(err) });
-      }
-    }
+    const outcomes = await Promise.all(
+      filePaths.map(async (filePath) => {
+        try {
+          const result = await client.repositories.uploadAttachment({
+            projectKey: opts.project,
+            repositorySlug: opts.repo,
+            filePath
+          });
+          return { ok: true, id: result.id, url: result.url };
+        } catch (err) {
+          return { ok: false, filePath, error: err instanceof Error ? err.message : String(err) };
+        }
+      })
+    );
+    const results = outcomes.filter((o) => o.ok).map(({ id, url }) => ({ id, url }));
+    const failed = outcomes.filter((o) => !o.ok).map(({ filePath, error }) => ({ filePath, error }));
     output({
       project: opts.project,
       repo: opts.repo,
@@ -943,8 +995,11 @@ Examples:
 }
 
 // src/commands/repo/list.ts
+import { Option as Option8 } from "commander";
+var VISIBILITIES = ["public", "private"];
+var ARCHIVE_STATES = ["ACTIVE", "ARCHIVED", "ALL"];
 function list3(parent) {
-  parent.command("list").description("List repositories with optional filters").option("--name <name>", "Filter by repository name (case-insensitive)").option("--project-key <key>", "Filter by project key").option("--project-name <name>", "Filter by project name (case-insensitive)").option("--visibility <type>", "Filter by visibility (public or private)").option("--archived <status>", "Filter by archived status (ACTIVE, ARCHIVED, ALL)").option("--start <n>", "Starting index for pagination (default: 0)", parseInt).option("--limit <n>", "Maximum results to return (default: 25)", parseInt).addHelpText(
+  parent.command("list").description("List repositories with optional filters").option("--name <name>", "Filter by repository name (case-insensitive)").option("--project-key <key>", "Filter by project key").option("--project-name <name>", "Filter by project name (case-insensitive)").addOption(new Option8("--visibility <type>", "Filter by visibility").choices(VISIBILITIES)).addOption(new Option8("--archived <status>", "Filter by archived status").choices(ARCHIVE_STATES)).option("--start <n>", "Starting index for pagination", nonNegativeInt).option("--limit <n>", "Maximum results to return (1-1000)", intInRange(1, 1e3), 25).addHelpText(
     "after",
     `
 Examples:
@@ -1019,10 +1074,20 @@ Examples:
 }
 
 // src/index.ts
+function readPackageVersion() {
+  try {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const pkgPath = join(here, "..", "package.json");
+    const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+    return pkg.version ?? "0.0.0";
+  } catch {
+    return "0.0.0";
+  }
+}
 var DIM = "\x1B[2m";
 var RESET = "\x1B[0m";
-var program = new Command8();
-program.name("bitbucketdc").description("Bitbucket Data Center CLI").version("1.0.0").configureHelp({
+var program = new Command9();
+program.name("bitbucketdc").description("Bitbucket Data Center CLI").version(readPackageVersion()).configureHelp({
   styleTitle: (str) => styleText("bold", str),
   styleUsage: (str) => styleText("dim", str),
   styleCommandDescription: (str) => styleText("dim", str),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bitbucketdc-cli",
-  "version": "1.0.12",
+  "version": "1.0.14",
   "publish": true,
   "type": "module",
   "main": "dist/index.js",
@@ -12,7 +12,7 @@
   ],
   "dependencies": {
     "commander": "^13.1.0",
-    "bitbucket-data-center-client": "1.4.15"
+    "bitbucket-data-center-client": "1.4.16"
   },
   "devDependencies": {
     "@types/node": "24.10.4",