bitbucketdc-cli 1.0.6 → 1.0.8

package/dist/index.js

@@ -1,42 +1,990 @@
 #!/usr/bin/env node
-import { styleText } from 'node:util';
-import { Command } from 'commander';
-import { registerCommitCommands } from './commands/commit/index.js';
-import { registerCompareCommands } from './commands/compare/index.js';
-import { registerFileCommands } from './commands/file/index.js';
-import { registerPrCommands } from './commands/pr/index.js';
-import { registerProjectCommands } from './commands/project/index.js';
-import { registerRepoCommands } from './commands/repo/index.js';
-import { registerUserCommands } from './commands/user/index.js';
-import { handleError } from './utils/output.js';
-const DIM = '\x1b[2m';
-const RESET = '\x1b[0m';
-const program = new Command();
-program
-    .name('bitbucketdc')
-    .description('Bitbucket Data Center CLI')
-    .version('1.0.0')
-    .configureHelp({
-    styleTitle: (str) => styleText('bold', str),
-    styleUsage: (str) => styleText('dim', str),
-    styleCommandDescription: (str) => styleText('dim', str),
-    styleOptionDescription: (str) => styleText('dim', str),
-    styleSubcommandDescription: (str) => styleText('dim', str),
-})
-    .addHelpText('beforeAll', `\n${styleText('bold', 'bitbucketdc')} ${DIM}— Bitbucket Data Center CLI${RESET}\n`)
-    .addHelpText('after', `
-${styleText('bold', 'Environment:')}
+
+// src/index.ts
+import { styleText } from "util";
+import { Command as Command8 } from "commander";
+
+// src/utils/client.ts
+import { BitbucketClient } from "bitbucket-data-center-client";
+
+// src/utils/credentials.ts
+function getCredentialInfo() {
+  const baseUrl = process.env.BITBUCKET_URL;
+  const token = process.env.BITBUCKET_TOKEN;
+  return {
+    environment: {
+      BITBUCKET_URL: {
+        value: baseUrl ?? null,
+        description: "Your Bitbucket Server base URL (e.g., https://bitbucket.example.com)"
+      },
+      BITBUCKET_TOKEN: {
+        value: token ? "<set>" : null,
+        description: "Personal Access Token"
+      }
+    },
+    tokenUrl: `${baseUrl ?? "https://bitbucket.example.com"}/plugins/servlet/access-tokens/users/<username>/manage`,
+    hint: "Export environment variables in your shell profile (e.g., ~/.zshrc)."
+  };
+}
+
+// src/utils/client.ts
+function getClient() {
+  const baseUrl = process.env.BITBUCKET_URL;
+  const token = process.env.BITBUCKET_TOKEN;
+  if (!baseUrl || !token) {
+    const missing = [...!baseUrl ? ["BITBUCKET_URL"] : [], ...!token ? ["BITBUCKET_TOKEN"] : []];
+    process.stderr.write(
+      `${JSON.stringify({
+        error: `Missing required environment variables: ${missing.join(", ")}`,
+        ...getCredentialInfo()
+      })}
+`
+    );
+    process.exit(1);
+  }
+  return new BitbucketClient({ baseUrl, token });
+}
+
+// src/utils/strip-response.ts
+function stripResponse(obj) {
+  if (Array.isArray(obj)) {
+    return obj.map(stripResponse);
+  }
+  if (obj === null || typeof obj !== "object") {
+    return obj;
+  }
+  const record = obj;
+  const result = {};
+  for (const [key, value] of Object.entries(record)) {
+    if (key === "self" || key === "links" || key === "_links" || key === "_expandable" || key === "expand" || key === "avatarUrls" || key === "avatarId" || key === "iconUrl") {
+      continue;
+    }
+    result[key] = stripResponse(value);
+  }
+  return result;
+}
+
+// src/utils/output.ts
+function output(data) {
+  process.stdout.write(`${JSON.stringify(stripResponse(data), null, 2)}
+`);
+}
+function handleError(err) {
+  const message = err instanceof Error ? err.message : String(err);
+  const axiosStatus = err?.response?.status;
+  if (axiosStatus === 400) {
+    const responseData = err?.response?.data;
+    const apiErrors = responseData && typeof responseData === "object" ? responseData : void 0;
+    process.stderr.write(
+      `${JSON.stringify({
+        error: "Bad request (HTTP 400)",
+        detail: apiErrors ?? message,
+        hint: "Check that all parameters are valid (project keys, repository slugs, branch names, etc.)."
+      })}
+`
+    );
+  } else if (axiosStatus === 401) {
+    process.stderr.write(
+      `${JSON.stringify({
+        error: "Authentication failed (HTTP 401)",
+        ...getCredentialInfo()
+      })}
+`
+    );
+  } else if (axiosStatus === 403) {
+    const responseData = err?.response?.data;
+    process.stderr.write(
+      `${JSON.stringify({
+        error: "Forbidden (HTTP 403)",
+        detail: responseData && typeof responseData === "object" ? responseData : message,
+        hint: "Your account does not have permission for this operation. Check repository permissions and token scope."
+      })}
+`
+    );
+  } else if (message.includes("ENOTFOUND") || message.includes("ECONNREFUSED") || message.includes("ECONNRESET")) {
+    process.stderr.write(
+      `${JSON.stringify({
+        error: `Cannot connect to Bitbucket server: ${message}`,
+        hint: "Verify that BITBUCKET_URL is correct and the server is reachable."
+      })}
+`
+    );
+  } else if (axiosStatus === 500) {
+    process.stderr.write(
+      `${JSON.stringify({
+        error: `Server error (HTTP 500): ${message}`,
+        hint: "The server returned an internal error. Check that all parameters are valid (project keys, repository slugs, branch names, IDs)."
+      })}
+`
+    );
+  } else {
+    process.stderr.write(`${JSON.stringify({ error: message })}
+`);
+  }
+  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(
+    "after",
+    `
+Examples:
+  bitbucketdc commit changes --project AI --repo my-app --commit abc123
+  bitbucketdc commit changes --project AI --repo my-app --commit abc123 --limit 100`
+  ).action(async (opts) => {
+    const client = getClient();
+    const result = await client.repositories.getCommitChanges({
+      projectKey: opts.project,
+      repositorySlug: opts.repo,
+      commitId: opts.commit,
+      limit: opts.limit,
+      start: opts.start
+    });
+    output(result);
+  });
+}
+
+// src/commands/commit/diff.ts
+import { Option } from "commander";
+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(
+    "after",
+    `
+Examples:
+  bitbucketdc commit diff --project AI --repo my-app --commit abc123
+  bitbucketdc commit diff --project AI --repo my-app --commit abc123 --path src/main.ts
+  bitbucketdc commit diff --project AI --repo my-app --commit abc123 --format json`
+  ).action(
+    async (opts) => {
+      const client = getClient();
+      const result = await client.repositories.getCommitDiff({
+        projectKey: opts.project,
+        repositorySlug: opts.repo,
+        commitId: opts.commit,
+        path: opts.path,
+        contextLines: opts.context,
+        whitespace: opts.whitespace,
+        format: opts.format || "text"
+      });
+      if (typeof result === "string") {
+        process.stdout.write(result);
+      } else {
+        output(result);
+      }
+    }
+  );
+}
+
+// src/commands/commit/index.ts
+function registerCommitCommands(program2) {
+  const commit = program2.command("commit").description("Commit inspection operations").addHelpText(
+    "after",
+    `
+Examples:
+  $ bitbucketdc commit changes --project AI --repo my-app --commit abc123
+  $ bitbucketdc commit diff --project AI --repo my-app --commit abc123
+  $ bitbucketdc commit diff --project AI --repo my-app --commit abc123 --path src/main.ts
+`
+  );
+  changes(commit);
+  diff(commit);
+}
+
+// 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(
+    "after",
+    `
+Examples:
+  bitbucketdc compare changes --project AI --repo my-app --from develop --to main
+  bitbucketdc compare changes --project AI --repo my-app --from feature/x --to main --limit 100
+  bitbucketdc compare changes --project AI --repo my-app --from develop --to main --start 25`
+  ).action(
+    async (opts) => {
+      const client = getClient();
+      const result = await client.repositories.getCompareChanges({
+        projectKey: opts.project,
+        repositorySlug: opts.repo,
+        from: opts.from,
+        to: opts.to,
+        limit: opts.limit,
+        start: opts.start
+      });
+      output(result);
+    }
+  );
+}
+
+// src/commands/compare/diff.ts
+import { Option as Option2 } from "commander";
+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(
+    "after",
+    `
+Examples:
+  bitbucketdc compare diff --project AI --repo my-app --from develop --to main
+  bitbucketdc compare diff --project AI --repo my-app --from develop --to main --path src/main.ts`
+  ).action(
+    async (opts) => {
+      const client = getClient();
+      const result = await client.repositories.getCompareDiff({
+        projectKey: opts.project,
+        repositorySlug: opts.repo,
+        from: opts.from,
+        to: opts.to,
+        path: opts.path,
+        contextLines: opts.context,
+        whitespace: opts.whitespace
+      });
+      output(result);
+    }
+  );
+}
+
+// src/commands/compare/index.ts
+function registerCompareCommands(program2) {
+  const compare = program2.command("compare").description("Compare refs (branches, tags, commits)").addHelpText(
+    "after",
+    `
+Examples:
+  $ bitbucketdc compare changes --project AI --repo my-app --from develop --to main
+  $ bitbucketdc compare diff --project AI --repo my-app --from develop --to main
+  $ bitbucketdc compare diff --project AI --repo my-app --from develop --to main --path src/main.ts
+`
+  );
+  changes2(compare);
+  diff2(compare);
+}
+
+// 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(
+    "after",
+    `
+Examples:
+  bitbucketdc file list --project PROJ --repo my-app
+  bitbucketdc file list --project PROJ --repo my-app --path src/
+  bitbucketdc file list --project PROJ --repo my-app --path src/ --at develop`
+  ).action(
+    async (opts) => {
+      const client = getClient();
+      const result = await client.repositories.browse({
+        projectKey: opts.project,
+        repositorySlug: opts.repo,
+        path: opts.path,
+        at: opts.at,
+        limit: opts.limit,
+        start: opts.start
+      });
+      output(result);
+    }
+  );
+}
+
+// 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(
+    "after",
+    `
+Examples:
+  bitbucketdc file show --project PROJ --repo my-app --path README.md
+  bitbucketdc file show --project PROJ --repo my-app --path config/settings.yaml --at release/2.0`
+  ).action(async (opts) => {
+    const client = getClient();
+    const result = await client.repositories.getRawContent({
+      projectKey: opts.project,
+      repositorySlug: opts.repo,
+      path: opts.path,
+      at: opts.at
+    });
+    process.stdout.write(result);
+  });
+}
+
+// src/commands/file/index.ts
+function registerFileCommands(program2) {
+  const file = program2.command("file").description("File and directory operations").addHelpText(
+    "after",
+    `
+Examples:
+  $ bitbucketdc file list --project PROJ --repo my-app
+  $ bitbucketdc file list --project PROJ --repo my-app --path src/ --at develop
+  $ bitbucketdc file show --project PROJ --repo my-app --path README.md
+`
+  );
+  list(file);
+  show(file);
+}
+
+// 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(
+    "--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(
+    "after",
+    `
+Examples:
+  bitbucketdc pr activities --project PROJ --repo my-repo --id 42
+  bitbucketdc pr activities --project PROJ --repo my-repo --id 42 --types COMMENTED,REVIEW_COMMENTED
+  bitbucketdc pr activities --project PROJ --repo my-repo --id 42 --types APPROVED,UNAPPROVED --limit 50`
+  ).action(
+    async (opts) => {
+      const client = getClient();
+      const result = await client.pullRequests.getActivities({
+        projectKey: opts.project,
+        repositorySlug: opts.repo,
+        pullRequestId: parseInt(opts.id),
+        start: opts.start,
+        limit: opts.limit
+      });
+      if (opts.types) {
+        const types = opts.types.split(",").map((t) => t.trim());
+        const filtered = result.values.filter((a) => types.includes(a.action));
+        output({ ...result, values: filtered, size: filtered.length });
+      } else {
+        output(result);
+      }
+    }
+  );
+}
+
+// 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) => {
+    const client = getClient();
+    const result = await client.pullRequests.canMerge({
+      projectKey: opts.project,
+      repositorySlug: opts.repo,
+      pullRequestId: opts.id
+    });
+    output(result);
+  });
+}
+
+// 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(
+    "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) => {
+    const client = getClient();
+    const result = await client.pullRequests.getChanges({
+      projectKey: opts.project,
+      repositorySlug: opts.repo,
+      pullRequestId: parseInt(opts.id),
+      limit: opts.limit
+    });
+    output(result);
+  });
+}
+
+// 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(
+    "after",
+    `
+Examples:
+  bitbucketdc pr comment --project PROJ --repo my-repo --id 42 --text "Looks good!"
+  bitbucketdc pr comment --project PROJ --repo my-repo --id 42 --text "I agree" --parent 123`
+  ).action(async (opts) => {
+    const client = getClient();
+    const result = await client.pullRequests.addComment({
+      projectKey: opts.project,
+      repositorySlug: opts.repo,
+      pullRequestId: parseInt(opts.id),
+      text: opts.text,
+      parentId: opts.parent ? parseInt(opts.parent) : void 0
+    });
+    output(result);
+  });
+}
+
+// src/commands/pr/create.ts
+function create(parent) {
+  parent.command("create").description("Create a new pull request").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--from <branch>", "Source branch name (e.g., feature-x)").requiredOption("--to <branch>", "Target branch name (e.g., main)").requiredOption("--title <text>", "Pull request title").option("--description <text>", "Pull request description in markdown").option("--reviewers <usernames>", "Comma-separated reviewer usernames").option("--draft", "Create as draft pull request").addHelpText(
+    "after",
+    `
+Examples:
+  bitbucketdc pr create --project PROJ --repo my-repo --from feature-x --to main --title "Add feature"
+  bitbucketdc pr create --project PROJ --repo my-repo --from fix/bug --to develop --title "Fix bug" --reviewers jsmith,jdoe
+  bitbucketdc pr create --project PROJ --repo my-repo --from wip --to main --title "WIP" --draft`
+  ).action(
+    async (opts) => {
+      const client = getClient();
+      let reviewers = opts.reviewers?.split(",").map((r) => r.trim());
+      if (!reviewers || reviewers.length === 0) {
+        const repo = await client.repositories.get({
+          projectKey: opts.project,
+          repositorySlug: opts.repo
+        });
+        const defaultReviewers = await client.pullRequests.getRequiredReviewers({
+          projectKey: opts.project,
+          repositorySlug: opts.repo,
+          repositoryId: repo.id,
+          sourceBranch: opts.from,
+          targetBranch: opts.to
+        });
+        reviewers = defaultReviewers.map((r) => r.name);
+      }
+      const result = await client.pullRequests.create({
+        projectKey: opts.project,
+        repositorySlug: opts.repo,
+        fromBranch: opts.from,
+        toBranch: opts.to,
+        title: opts.title,
+        description: opts.description,
+        reviewers,
+        draft: opts.draft
+      });
+      output(result);
+    }
+  );
+}
+
+// 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) => {
+    const client = getClient();
+    const result = await client.pullRequests.decline({
+      projectKey: opts.project,
+      repositorySlug: opts.repo,
+      pullRequestId: opts.id
+    });
+    output(result);
+  });
+}
+
+// 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(
+    "after",
+    "\nExamples:\n  bitbucketdc pr delete-comment --project PROJ --repo my-repo --id 42 --comment-id 123"
+  ).action(async (opts) => {
+    const client = getClient();
+    const comment2 = await client.pullRequests.getComment({
+      projectKey: opts.project,
+      repositorySlug: opts.repo,
+      pullRequestId: opts.id,
+      commentId: opts.commentId
+    });
+    await client.pullRequests.deleteComment({
+      projectKey: opts.project,
+      repositorySlug: opts.repo,
+      pullRequestId: opts.id,
+      commentId: opts.commentId,
+      version: comment2.version
+    });
+    output({ deleted: true, commentId: opts.commentId });
+  });
+}
+
+// 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) => {
+    const client = getClient();
+    await client.pullRequests.deletePullRequest({
+      projectKey: opts.project,
+      repositorySlug: opts.repo,
+      pullRequestId: opts.id
+    });
+    output({ deleted: true, pullRequestId: opts.id });
+  });
+}
+
+// src/commands/pr/diff.ts
+import { Option as Option3 } from "commander";
+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(
+    "after",
+    `
+Examples:
+  bitbucketdc pr diff --project PROJ --repo my-repo --id 42
+  bitbucketdc pr diff --project PROJ --repo my-repo --id 42 --path src/main.ts
+  bitbucketdc pr diff --project PROJ --repo my-repo --id 42 --format json
+  bitbucketdc pr diff --project PROJ --repo my-repo --id 42 --context 5 --whitespace ignore-all`
+  ).action(
+    async (opts) => {
+      const client = getClient();
+      const result = await client.pullRequests.getDiff({
+        projectKey: opts.project,
+        repositorySlug: opts.repo,
+        pullRequestId: parseInt(opts.id),
+        path: opts.path,
+        sinceId: opts.since,
+        untilId: opts.until,
+        contextLines: opts.context,
+        whitespace: opts.whitespace,
+        format: opts.format || "text"
+      });
+      if (typeof result === "string") {
+        process.stdout.write(result);
+      } else {
+        output(result);
+      }
+    }
+  );
+}
+
+// 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(
+    "after",
+    '\nExamples:\n  bitbucketdc pr edit-comment --project PROJ --repo my-repo --id 42 --comment-id 123 --text "Updated text"'
+  ).action(async (opts) => {
+    const client = getClient();
+    const comment2 = await client.pullRequests.getComment({
+      projectKey: opts.project,
+      repositorySlug: opts.repo,
+      pullRequestId: opts.id,
+      commentId: opts.commentId
+    });
+    const result = await client.pullRequests.editComment({
+      projectKey: opts.project,
+      repositorySlug: opts.repo,
+      pullRequestId: opts.id,
+      commentId: opts.commentId,
+      text: opts.text,
+      version: comment2.version
+    });
+    output(result);
+  });
+}
+
+// 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(
+    "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) => {
+    const client = getClient();
+    const result = await client.pullRequests.addComment({
+      projectKey: opts.project,
+      repositorySlug: opts.repo,
+      pullRequestId: parseInt(opts.id),
+      text: opts.text,
+      path: opts.path
+    });
+    output(result);
+  });
+}
+
+// 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(
+    "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) => {
+    const client = getClient();
+    const result = await client.pullRequests.getFileDiff({
+      projectKey: opts.project,
+      repositorySlug: opts.repo,
+      pullRequestId: parseInt(opts.id),
+      path: opts.path,
+      contextLines: opts.context
+    });
+    output(result);
+  });
+}
+
+// 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) => {
+    const client = getClient();
+    const result = await client.pullRequests.get({
+      projectKey: opts.project,
+      repositorySlug: opts.repo,
+      pullRequestId: parseInt(opts.id)
+    });
+    output(result);
+  });
+}
+
+// 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(
+    "after",
+    "\nExamples:\n  bitbucketdc pr inbox\n  bitbucketdc pr inbox --limit 10\n  bitbucketdc pr inbox --start 25 --limit 25"
+  ).action(async (opts) => {
+    const client = getClient();
+    const result = await client.pullRequests.getInbox({
+      start: opts.start,
+      limit: opts.limit
+    });
+    output(result);
+  });
+}
+
+// src/commands/pr/line-comment.ts
+import { Option as Option4 } from "commander";
+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()
+  ).addHelpText(
+    "after",
+    `
+Examples:
+  bitbucketdc pr line-comment --project PROJ --repo my-repo --id 42 --text "Use const here" --path src/main.ts --line 15 --line-type ADDED --file-type TO
+  bitbucketdc pr line-comment --project PROJ --repo my-repo --id 42 --text "Was this intentional?" --path src/old.ts --line 8 --line-type REMOVED --file-type FROM`
+  ).action(
+    async (opts) => {
+      const client = getClient();
+      const result = await client.pullRequests.addComment({
+        projectKey: opts.project,
+        repositorySlug: opts.repo,
+        pullRequestId: parseInt(opts.id),
+        text: opts.text,
+        path: opts.path,
+        line: parseInt(opts.line),
+        lineType: opts.lineType,
+        fileType: opts.fileType
+      });
+      output(result);
+    }
+  );
+}
+
+// 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(
+    "after",
+    `
+Examples:
+  bitbucketdc pr merge --project PROJ --repo my-repo --id 42
+  bitbucketdc pr merge --project PROJ --repo my-repo --id 42 --strategy squash
+  bitbucketdc pr merge --project PROJ --repo my-repo --id 42 --message "Merge feature X"`
+  ).action(async (opts) => {
+    const client = getClient();
+    const result = await client.pullRequests.merge({
+      projectKey: opts.project,
+      repositorySlug: opts.repo,
+      pullRequestId: opts.id,
+      strategyId: opts.strategy,
+      message: opts.message
+    });
+    output(result);
+  });
+}
+
+// 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(
+    new Option5("--emoticon <name>", "Emoticon to react with").choices(["thumbsup", "thumbsdown", "heart", "thinking_face", "laughing"]).makeOptionMandatory()
+  ).addHelpText(
+    "after",
+    `
+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);
+  });
+}
+
+// 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(
+    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 });
+  });
+}
+
+// src/commands/pr/review.ts
+import { Option as Option7 } from "commander";
+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(
+    "after",
+    `
+Examples:
+  bitbucketdc pr review --project PROJ --repo my-repo --id 42 --status APPROVED
+  bitbucketdc pr review --project PROJ --repo my-repo --id 42 --status NEEDS_WORK
+  bitbucketdc pr review --project PROJ --repo my-repo --id 42 --status UNAPPROVED`
+  ).action(async (opts) => {
+    const client = getClient();
+    const result = await client.pullRequests.updateReviewStatus({
+      projectKey: opts.project,
+      repositorySlug: opts.repo,
+      pullRequestId: parseInt(opts.id),
+      status: opts.status
+    });
+    output(result);
+  });
+}
+
+// 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(
+    "after",
+    `
+Examples:
+  bitbucketdc pr update --project PROJ --repo my-repo --id 42 --title "New title"
+  bitbucketdc pr update --project PROJ --repo my-repo --id 42 --description "Updated description"
+  bitbucketdc pr update --project PROJ --repo my-repo --id 42 --title "New" --description "Both"`
+  ).action(async (opts) => {
+    if (!opts.title && !opts.description) {
+      process.stderr.write(`${JSON.stringify({ error: "At least one of --title or --description is required" })}
+`);
+      process.exit(1);
+    }
+    const client = getClient();
+    const result = await client.pullRequests.update({
+      projectKey: opts.project,
+      repositorySlug: opts.repo,
+      pullRequestId: opts.id,
+      title: opts.title,
+      description: opts.description
+    });
+    output(result);
+  });
+}
+
+// src/commands/pr/index.ts
+function registerPrCommands(program2) {
+  const pr = program2.command("pr").description("Pull request operations").addHelpText(
+    "after",
+    `
+Examples:
+  $ bitbucketdc pr inbox
+  $ bitbucketdc pr get --project PROJ --repo my-repo --id 42
+  $ bitbucketdc pr changes --project PROJ --repo my-repo --id 42
+  $ bitbucketdc pr diff --project PROJ --repo my-repo --id 42
+  $ bitbucketdc pr create --project PROJ --repo my-repo --from feature-x --to main --title "Add feature"
+  $ bitbucketdc pr comment --project PROJ --repo my-repo --id 42 --text "Looks good!"
+  $ bitbucketdc pr review --project PROJ --repo my-repo --id 42 --status APPROVED
+  $ bitbucketdc pr update --project PROJ --repo my-repo --id 42 --title "New title"
+  $ bitbucketdc pr can-merge --project PROJ --repo my-repo --id 42
+  $ bitbucketdc pr merge --project PROJ --repo my-repo --id 42
+  $ bitbucketdc pr decline --project PROJ --repo my-repo --id 42
+  $ bitbucketdc pr delete --project PROJ --repo my-repo --id 42
+`
+  );
+  inbox(pr);
+  get(pr);
+  changes3(pr);
+  diff3(pr);
+  fileDiff(pr);
+  activities(pr);
+  create(pr);
+  comment(pr);
+  fileComment(pr);
+  lineComment(pr);
+  deleteComment(pr);
+  editComment(pr);
+  reactionAdd(pr);
+  reactionRemove(pr);
+  review(pr);
+  update(pr);
+  canMerge(pr);
+  merge(pr);
+  decline(pr);
+  deletePr(pr);
+}
+
+// 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(
+    "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) => {
+    const client = getClient();
+    const result = await client.projects.list({
+      name: opts.name,
+      permission: opts.permission,
+      start: opts.start,
+      limit: opts.limit
+    });
+    output(result);
+  });
+}
+
+// src/commands/project/index.ts
+function registerProjectCommands(program2) {
+  const project = program2.command("project").description("Project operations").addHelpText(
+    "after",
+    `
+Examples:
+  $ bitbucketdc project list
+  $ bitbucketdc project list --name "My Project" --limit 10
+`
+  );
+  list2(project);
+}
+
+// src/commands/repo/attachment/download.ts
+function download(parent) {
+  parent.command("download").description("Download a repository attachment to disk").requiredOption("--project <key>", "Project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <attachmentId>", "Attachment ID").requiredOption("--output <path>", "Destination file path").addHelpText(
+    "after",
+    "\nExamples:\n  bitbucketdc repo attachment download --project PROJ --repo my-repo --id abc123 --output ./file.png"
+  ).action(async (opts) => {
+    const client = getClient();
+    await client.repositories.downloadAttachment({
+      projectKey: opts.project,
+      repositorySlug: opts.repo,
+      attachmentId: opts.id,
+      destinationPath: opts.output
+    });
+    output({ downloaded: true, path: opts.output, attachmentId: opts.id });
+  });
+}
+
+// src/commands/repo/attachment/upload.ts
+function upload(parent) {
+  parent.command("upload").description("Upload file attachments to a repository").requiredOption("--project <key>", "Project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--files <paths>", "Comma-separated local file paths").addHelpText(
+    "after",
+    "\nExamples:\n  bitbucketdc repo attachment upload --project PROJ --repo my-repo --files screenshot.png\n  bitbucketdc repo attachment upload --project PROJ --repo my-repo --files file1.png,file2.pdf"
+  ).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) });
+      }
+    }
+    output({
+      project: opts.project,
+      repo: opts.repo,
+      uploaded: results.length,
+      attachments: results,
+      ...failed.length > 0 && { failed }
+    });
+  });
+}
+
+// src/commands/repo/attachment/index.ts
+function registerAttachmentCommands(parent) {
+  const attachment = parent.command("attachment").description("Attachment operations").addHelpText(
+    "after",
+    `
+Examples:
+  $ bitbucketdc repo attachment download --project PROJ --repo my-repo --id 706 --output ./image.png
+  $ bitbucketdc repo attachment upload --project PROJ --repo my-repo --files screenshot.png,report.pdf
+`
+  );
+  download(attachment);
+  upload(attachment);
+}
+
+// src/commands/repo/list.ts
+function list3(parent) {
+  parent.command("list <projectKey>").description("List repositories in a project").addHelpText("after", "\nExamples:\n  bitbucketdc repo list PROJ\n  bitbucketdc repo list MYPROJ").action(async (projectKey) => {
+    const client = getClient();
+    const result = await client.repositories.list({ projectKey });
+    output(result);
+  });
+}
+
+// src/commands/repo/index.ts
+function registerRepoCommands(program2) {
+  const repo = program2.command("repo").description("Repository operations").addHelpText(
+    "after",
+    `
+Examples:
+  $ bitbucketdc repo list PROJ
+  $ bitbucketdc repo attachment download --project PROJ --repo my-repo --id abc123 --output ./file.png
+`
+  );
+  list3(repo);
+  registerAttachmentCommands(repo);
+}
+
+// src/commands/user/list.ts
+function list4(parent) {
+  parent.command("list").description("List all users").option("--filter <filter>", "Filter users by username, name or email (partial match)").addHelpText("after", "\nExamples:\n  bitbucketdc user list\n  bitbucketdc user list --filter john").action(async (opts) => {
+    const client = getClient();
+    const result = await client.users.getAll(opts.filter ? { filter: opts.filter } : void 0);
+    output(result);
+  });
+}
+
+// src/commands/user/profile.ts
+function profile(parent) {
+  parent.command("profile <username>").description("Get a user profile by username").addHelpText("after", "\nExamples:\n  bitbucketdc user profile jsmith\n  bitbucketdc user profile admin").action(async (username) => {
+    const client = getClient();
+    const result = await client.users.getProfile({ username });
+    output(result);
+  });
+}
+
+// src/commands/user/index.ts
+function registerUserCommands(program2) {
+  const user = program2.command("user").description("User operations").addHelpText(
+    "after",
+    `
+Examples:
+  $ bitbucketdc user profile jsmith
+  $ bitbucketdc user list --filter john
+`
+  );
+  profile(user);
+  list4(user);
+}
+
+// src/index.ts
+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({
+  styleTitle: (str) => styleText("bold", str),
+  styleUsage: (str) => styleText("dim", str),
+  styleCommandDescription: (str) => styleText("dim", str),
+  styleOptionDescription: (str) => styleText("dim", str),
+  styleSubcommandDescription: (str) => styleText("dim", str)
+}).addHelpText("beforeAll", `
+${styleText("bold", "bitbucketdc")} ${DIM}\u2014 Bitbucket Data Center CLI${RESET}
+`).addHelpText(
+  "after",
+  `
+${styleText("bold", "Environment:")}
   BITBUCKET_URL      Bitbucket Server base URL ${DIM}(e.g., https://bitbucket.example.com)${RESET}
   BITBUCKET_TOKEN    Personal Access Token ${DIM}(generate in Bitbucket > Profile > Personal Access Tokens)${RESET}
 
-${styleText('bold', 'Examples:')}
+${styleText("bold", "Examples:")}
   ${DIM}$${RESET} bitbucketdc user profile jsmith
   ${DIM}$${RESET} bitbucketdc user list --filter john
   ${DIM}$${RESET} bitbucketdc project list --name "My Project"
   ${DIM}$${RESET} bitbucketdc repo list PROJ
   ${DIM}$${RESET} bitbucketdc pr inbox
   ${DIM}$${RESET} bitbucketdc pr get --project PROJ --repo my-repo --pr 42
-`);
+`
+);
 registerUserCommands(program);
 registerProjectCommands(program);
 registerRepoCommands(program);
@@ -45,9 +993,7 @@ registerCommitCommands(program);
 registerCompareCommands(program);
 registerPrCommands(program);
 try {
-    await program.parseAsync();
-}
-catch (err) {
-    handleError(err);
+  await program.parseAsync();
+} catch (err) {
+  handleError(err);
 }
-//# sourceMappingURL=index.js.map