@pilatos/bitbucket-cli 1.15.0 → 1.16.1

package/dist/index.js

@@ -17440,6 +17440,8 @@ var ServiceTokens = {
   AddDefaultReviewerCommand: "AddDefaultReviewerCommand",
   RemoveDefaultReviewerCommand: "RemoveDefaultReviewerCommand",
   DefaultReviewerService: "DefaultReviewerService",
+  UrlBuilderService: "UrlBuilderService",
+  BrowseCommand: "BrowseCommand",
   CreatePRCommand: "CreatePRCommand",
   ListPRsCommand: "ListPRsCommand",
   ViewPRCommand: "ViewPRCommand",
@@ -17631,7 +17633,16 @@ class ConfigService {
       await this.verifyPermissions(this.configDir, CONFIG_DIR_MODE, "directory");
       await this.verifyPermissions(this.configFile, CONFIG_FILE_MODE, "file");
       const data = await fs.readFile(this.configFile, "utf-8");
-      this.configCache = JSON.parse(data);
+      try {
+        this.configCache = JSON.parse(data);
+      } catch (parseError) {
+        throw new BBError({
+          code: 4001 /* CONFIG_READ_FAILED */,
+          message: `Config file is not valid JSON: ${this.configFile}. Fix the file by hand or remove it and run \`bb auth login\` again.`,
+          cause: parseError instanceof Error ? parseError : undefined,
+          context: { configFile: this.configFile }
+        });
+      }
       return this.configCache;
     } catch (error) {
       if (error.code === "ENOENT") {
@@ -17769,10 +17780,14 @@ class ConfigService {
   }
 }
 // src/services/git.service.ts
+var DEFAULT_GIT_TIMEOUT_MS = 60000;
+
 class GitService {
   cwd;
-  constructor(cwd) {
+  timeoutMs;
+  constructor(cwd, options = {}) {
     this.cwd = cwd ?? process.cwd();
+    this.timeoutMs = options.timeoutMs ?? DEFAULT_GIT_TIMEOUT_MS;
   }
   async exec(args, cwd) {
     const proc = Bun.spawn(["git", ...args], {
@@ -17780,14 +17795,28 @@ class GitService {
       stdout: "pipe",
       stderr: "pipe"
     });
-    const stdout = await new Response(proc.stdout).text();
-    const stderr = await new Response(proc.stderr).text();
-    const exitCode = await proc.exited;
-    return {
-      stdout: stdout.trim(),
-      stderr: stderr.trim(),
-      exitCode
-    };
+    let timedOut = false;
+    const timer = setTimeout(() => {
+      timedOut = true;
+      try {
+        proc.kill();
+      } catch {}
+    }, this.timeoutMs);
+    try {
+      const stdout = await new Response(proc.stdout).text();
+      const stderr = await new Response(proc.stderr).text();
+      const exitCode = await proc.exited;
+      if (timedOut) {
+        throw new GitError(`git ${args.join(" ")} timed out after ${this.timeoutMs}ms`, `git ${args.join(" ")}`, exitCode);
+      }
+      return {
+        stdout: stdout.trim(),
+        stderr: stderr.trim(),
+        exitCode
+      };
+    } finally {
+      clearTimeout(timer);
+    }
   }
   async execOrError(args, cwd) {
     const result = await this.exec(args, cwd);
@@ -17823,6 +17852,9 @@ class GitService {
   async getCurrentBranch() {
     return this.execOrError(["rev-parse", "--abbrev-ref", "HEAD"]);
   }
+  async getCurrentCommit() {
+    return this.execOrError(["rev-parse", "HEAD"]);
+  }
   async getRemoteUrl(remote = "origin") {
     const result = await this.exec(["remote", "get-url", remote]);
     if (result.exitCode !== 0) {
@@ -17835,7 +17867,7 @@ class GitService {
     return result.stdout;
   }
   withCwd(cwd) {
-    return new GitService(cwd);
+    return new GitService(cwd, { timeoutMs: this.timeoutMs });
   }
 }
 // src/services/context.service.ts
@@ -17935,6 +17967,12 @@ class ContextService {
     }
     return result.context;
   }
+  async requireRepoContextFor(options, context) {
+    return this.requireRepoContext({
+      ...context.globalOptions,
+      ...options
+    });
+  }
   buildRepoNotFoundMessage(reason, remoteUrl) {
     const fallback = "Use --workspace and --repo options, or run this command from within a Bitbucket repository.";
     switch (reason) {
@@ -18566,6 +18604,15 @@ class OutputService {
   text(message) {
     console.log(stripControl(message));
   }
+  truncate(text, maxLength, suffix = "...") {
+    if (maxLength <= 0 || text.length <= maxLength) {
+      return text;
+    }
+    if (suffix.length >= maxLength) {
+      return text.slice(0, maxLength);
+    }
+    return text.slice(0, maxLength - suffix.length) + suffix;
+  }
   formatDate(date) {
     const d = typeof date === "string" ? new Date(date) : date;
     return d.toLocaleDateString("en-US", {
@@ -18635,7 +18682,17 @@ function projectByFieldsRespectingWrapper(data, fields) {
   return projectFields(data, fields);
 }
 async function runJq(data, expression) {
-  const jq = await Promise.resolve().then(() => __toESM(require_dist(), 1));
+  let jq;
+  try {
+    jq = await Promise.resolve().then(() => __toESM(require_dist(), 1));
+  } catch (error) {
+    throw new BBError({
+      code: 8001 /* JQ_FAILED */,
+      message: "Failed to load the embedded jq runtime (jq-wasm). Reinstall the CLI or report this issue.",
+      cause: error instanceof Error ? error : undefined,
+      context: { expression }
+    });
+  }
   let result;
   try {
     result = await jq.raw(data, expression);
@@ -18807,7 +18864,11 @@ class VersionService {
         latestVersion,
         updateAvailable
       };
-    } catch {
+    } catch (error) {
+      if (process.env.DEBUG === "true") {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`[version-check] skipped: ${message}`);
+      }
       return null;
     }
   }
@@ -22941,7 +23002,12 @@ class OAuthService {
         try {
           const open2 = (await Promise.resolve().then(() => (init_open(), exports_open))).default;
           await open2(authUrl);
-        } catch {}
+        } catch (err) {
+          if (process.env.DEBUG === "true") {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(`[oauth] could not open browser: ${message}`);
+          }
+        }
         console.error(`If the browser doesn't open, visit:
 ${authUrl}
 `);
@@ -23376,6 +23442,67 @@ function accountToEntry(account) {
     nickname: asUser.nickname
   };
 }
+// src/services/url-builder.service.ts
+var BITBUCKET_WEB_BASE = "https://bitbucket.org";
+function encodePathSegments(path3) {
+  return path3.split("/").map((segment) => encodeURIComponent(segment)).join("/");
+}
+
+class UrlBuilderService {
+  base;
+  constructor(base = BITBUCKET_WEB_BASE) {
+    this.base = base.replace(/\/+$/, "");
+  }
+  repo(ctx) {
+    return this.repoBase(ctx);
+  }
+  src(ctx, branch, path3, line) {
+    const encodedBranch = encodeURIComponent(branch);
+    const trimmedPath = path3?.replace(/^\/+/, "").replace(/\/+$/, "") ?? "";
+    const pathPart = trimmedPath ? `/${encodePathSegments(trimmedPath)}` : "/";
+    const lineFragment = typeof line === "number" && Number.isFinite(line) && line > 0 ? `#lines-${line}` : "";
+    return `${this.repoBase(ctx)}/src/${encodedBranch}${pathPart}${lineFragment}`;
+  }
+  branchList(ctx) {
+    return `${this.repoBase(ctx)}/branches/`;
+  }
+  commit(ctx, sha) {
+    return `${this.repoBase(ctx)}/commits/${encodeURIComponent(sha)}`;
+  }
+  commitList(ctx) {
+    return `${this.repoBase(ctx)}/commits/`;
+  }
+  pullRequest(ctx, id) {
+    return `${this.repoBase(ctx)}/pull-requests/${id}`;
+  }
+  pullRequestList(ctx) {
+    return `${this.repoBase(ctx)}/pull-requests/`;
+  }
+  pipelinesHome(ctx) {
+    return `${this.repoBase(ctx)}/pipelines`;
+  }
+  pipelineRun(ctx, idOrUuid) {
+    return `${this.repoBase(ctx)}/pipelines/results/${encodeURIComponent(idOrUuid)}`;
+  }
+  downloads(ctx) {
+    return `${this.repoBase(ctx)}/downloads/`;
+  }
+  issue(ctx, id) {
+    return `${this.repoBase(ctx)}/issues/${id}`;
+  }
+  issueList(ctx) {
+    return `${this.repoBase(ctx)}/issues`;
+  }
+  wiki(ctx) {
+    return `${this.repoBase(ctx)}/wiki`;
+  }
+  settings(ctx) {
+    return `${this.repoBase(ctx)}/admin`;
+  }
+  repoBase(ctx) {
+    return `${this.base}/${encodeURIComponent(ctx.workspace)}/${encodeURIComponent(ctx.repoSlug)}`;
+  }
+}
 // src/bootstrap.ts
 import { createRequire } from "module";
 
@@ -27201,6 +27328,18 @@ class BaseCommand {
     }
     return parsed;
   }
+  parsePositiveInt(value, name) {
+    const trimmed = value.trim();
+    const parsed = Number.parseInt(trimmed, 10);
+    if (!Number.isFinite(parsed) || parsed < 1 || String(parsed) !== trimmed) {
+      throw new BBError({
+        code: 5002 /* VALIDATION_INVALID */,
+        message: this.appendHelpHint(`--${name} must be a positive integer.`),
+        context: { [name]: value }
+      });
+    }
+    return parsed;
+  }
   parseEnumOption(value, name, allowed) {
     if (!allowed.includes(value)) {
       throw new BBError({
@@ -28028,10 +28167,7 @@ class ListDefaultReviewersCommand extends BaseCommand {
     this.contextService = contextService;
   }
   async execute(options, context) {
-    const repoContext = await this.contextService.requireRepoContext({
-      ...context.globalOptions,
-      ...options
-    });
+    const repoContext = await this.contextService.requireRepoContextFor(options, context);
     const mode = options.repoOnly ? "direct" : "effective";
     const reviewers = await this.defaultReviewerService.list(repoContext, mode);
     if (context.globalOptions.json) {
@@ -28074,10 +28210,7 @@ class AddDefaultReviewerCommand extends BaseCommand {
     this.contextService = contextService;
   }
   async execute(options, context) {
-    const repoContext = await this.contextService.requireRepoContext({
-      ...context.globalOptions,
-      ...options
-    });
+    const repoContext = await this.contextService.requireRepoContextFor(options, context);
     const userResponse = await this.usersApi.usersSelectedUserGet({
       selectedUser: options.username
     });
@@ -28111,10 +28244,7 @@ class RemoveDefaultReviewerCommand extends BaseCommand {
     this.contextService = contextService;
   }
   async execute(options, context) {
-    const repoContext = await this.contextService.requireRepoContext({
-      ...context.globalOptions,
-      ...options
-    });
+    const repoContext = await this.contextService.requireRepoContextFor(options, context);
     if (!options.yes) {
       throw new BBError({
         code: 5001 /* VALIDATION_REQUIRED */,
@@ -28166,10 +28296,7 @@ class CreatePRCommand extends BaseCommand {
         message: this.appendHelpHint("Pull request title is required. Use --title option.")
       });
     }
-    const repoContext = await this.contextService.requireRepoContext({
-      ...context.globalOptions,
-      ...options
-    });
+    const repoContext = await this.contextService.requireRepoContextFor(options, context);
     let sourceBranch = options.source;
     if (!sourceBranch) {
       sourceBranch = await this.gitService.getCurrentBranch();
@@ -28294,10 +28421,7 @@ class ListPRsCommand extends BaseCommand {
     this.contextService = contextService;
   }
   async execute(options, context) {
-    const repoContext = await this.contextService.requireRepoContext({
-      ...context.globalOptions,
-      ...options
-    });
+    const repoContext = await this.contextService.requireRepoContextFor(options, context);
     const state = options.state ? this.parseEnumOption(options.state, "state", PR_STATES) : "OPEN";
     const limit = parseLimit(options.limit);
     const reviewerQuery = options.mine ? await this.buildMineFilter() : undefined;
@@ -28341,19 +28465,13 @@ class ListPRsCommand extends BaseCommand {
       const destination = pr.destination;
       return [
         `#${pr.id}`,
-        this.truncate(title ?? "", 50),
+        this.output.truncate(title ?? "", 50),
         pr.author?.display_name ?? "Unknown",
         `${source?.branch?.name ?? "unknown"} \u2192 ${destination?.branch?.name ?? "unknown"}`
       ];
     });
     this.output.table(["ID", "TITLE", "AUTHOR", "BRANCHES"], rows);
   }
-  truncate(text, maxLength) {
-    if (text.length <= maxLength) {
-      return text;
-    }
-    return text.substring(0, maxLength - 3) + "...";
-  }
   async buildMineFilter() {
     const response = await this.usersApi.userGet();
     const userUuid = response.data.uuid;
@@ -28377,11 +28495,8 @@ class ViewPRCommand extends BaseCommand {
     this.contextService = contextService;
   }
   async execute(options, context) {
-    const repoContext = await this.contextService.requireRepoContext({
-      ...context.globalOptions,
-      ...options
-    });
-    const prId = this.parseIntOption(options.id, "id");
+    const repoContext = await this.contextService.requireRepoContextFor(options, context);
+    const prId = this.parsePositiveInt(options.id, "id");
     const response = await this.pullrequestsApi.repositoriesWorkspaceRepoSlugPullrequestsPullRequestIdGet({
       workspace: repoContext.workspace,
       repoSlug: repoContext.repoSlug,
@@ -28506,13 +28621,10 @@ class EditPRCommand extends BaseCommand {
     this.gitService = gitService;
   }
   async execute(options, context) {
-    const repoContext = await this.contextService.requireRepoContext({
-      ...context.globalOptions,
-      ...options
-    });
+    const repoContext = await this.contextService.requireRepoContextFor(options, context);
     let prId;
     if (options.id) {
-      prId = Number.parseInt(options.id, 10);
+      prId = this.parsePositiveInt(options.id, "id");
     } else {
       const currentBranch = await this.gitService.getCurrentBranch();
       const matches = await collectPages({
@@ -28587,7 +28699,7 @@ class EditPRCommand extends BaseCommand {
     this.output.success(`Updated pull request #${pr.id}`);
     this.output.text(`  ${this.output.dim("Title:")} ${pr.title}`);
     if (pr.description) {
-      const truncatedDesc = pr.description.length > 100 ? pr.description.substring(0, 100) + "..." : pr.description;
+      const truncatedDesc = this.output.truncate(pr.description, 100);
       this.output.text(`  ${this.output.dim("Description:")} ${truncatedDesc}`);
     }
     this.output.text(`  ${this.output.dim("URL:")} ${links?.html?.href}`);
@@ -28608,11 +28720,8 @@ class MergePRCommand extends BaseCommand {
     this.contextService = contextService;
   }
   async execute(options, context) {
-    const repoContext = await this.contextService.requireRepoContext({
-      ...context.globalOptions,
-      ...options
-    });
-    const prId = this.parseIntOption(options.id, "id");
+    const repoContext = await this.contextService.requireRepoContextFor(options, context);
+    const prId = this.parsePositiveInt(options.id, "id");
     const request = {
       type: "pullrequest_merge_parameters"
     };
@@ -28656,11 +28765,8 @@ class ApprovePRCommand extends BaseCommand {
     this.contextService = contextService;
   }
   async execute(options, context) {
-    const repoContext = await this.contextService.requireRepoContext({
-      ...context.globalOptions,
-      ...options
-    });
-    const prId = Number.parseInt(options.id, 10);
+    const repoContext = await this.contextService.requireRepoContextFor(options, context);
+    const prId = this.parsePositiveInt(options.id, "id");
     await this.pullrequestsApi.repositoriesWorkspaceRepoSlugPullrequestsPullRequestIdApprovePost({
       workspace: repoContext.workspace,
       repoSlug: repoContext.repoSlug,
@@ -28689,11 +28795,8 @@ class DeclinePRCommand extends BaseCommand {
     this.contextService = contextService;
   }
   async execute(options, context) {
-    const repoContext = await this.contextService.requireRepoContext({
-      ...context.globalOptions,
-      ...options
-    });
-    const prId = Number.parseInt(options.id, 10);
+    const repoContext = await this.contextService.requireRepoContextFor(options, context);
+    const prId = this.parsePositiveInt(options.id, "id");
     const response = await this.pullrequestsApi.repositoriesWorkspaceRepoSlugPullrequestsPullRequestIdDeclinePost({
       workspace: repoContext.workspace,
       repoSlug: repoContext.repoSlug,
@@ -28724,11 +28827,8 @@ class ReadyPRCommand extends BaseCommand {
     this.contextService = contextService;
   }
   async execute(options, context) {
-    const repoContext = await this.contextService.requireRepoContext({
-      ...context.globalOptions,
-      ...options
-    });
-    const prId = Number.parseInt(options.id, 10);
+    const repoContext = await this.contextService.requireRepoContextFor(options, context);
+    const prId = this.parsePositiveInt(options.id, "id");
     const response = await this.pullrequestsApi.repositoriesWorkspaceRepoSlugPullrequestsPullRequestIdPut({
       workspace: repoContext.workspace,
       repoSlug: repoContext.repoSlug,
@@ -28766,11 +28866,8 @@ class CheckoutPRCommand extends BaseCommand {
     this.gitService = gitService;
   }
   async execute(options, context) {
-    const repoContext = await this.contextService.requireRepoContext({
-      ...context.globalOptions,
-      ...options
-    });
-    const prId = Number.parseInt(options.id, 10);
+    const repoContext = await this.contextService.requireRepoContextFor(options, context);
+    const prId = this.parsePositiveInt(options.id, "id");
     const prResponse = await this.pullrequestsApi.repositoriesWorkspaceRepoSlugPullrequestsPullRequestIdGet({
       workspace: repoContext.workspace,
       repoSlug: repoContext.repoSlug,
@@ -28833,20 +28930,10 @@ class DiffPRCommand extends BaseCommand {
     this.gitService = gitService;
   }
   async execute(options, context) {
-    const repoContext = await this.contextService.requireRepoContext({
-      ...context.globalOptions,
-      ...options
-    });
+    const repoContext = await this.contextService.requireRepoContextFor(options, context);
     let prId;
     if (options.id) {
-      prId = Number.parseInt(options.id, 10);
-      if (Number.isNaN(prId)) {
-        throw new BBError({
-          code: 5002 /* VALIDATION_INVALID */,
-          message: "Invalid PR ID",
-          context: { id: options.id }
-        });
-      }
+      prId = this.parsePositiveInt(options.id, "id");
     } else {
       const currentBranch = await this.gitService.getCurrentBranch();
       const matches = await collectPages({
@@ -29063,11 +29150,8 @@ class ActivityPRCommand extends BaseCommand {
     this.contextService = contextService;
   }
   async execute(options, context) {
-    const repoContext = await this.contextService.requireRepoContext({
-      ...context.globalOptions,
-      ...options
-    });
-    const prId = this.parseIntOption(options.id, "id");
+    const repoContext = await this.contextService.requireRepoContextFor(options, context);
+    const prId = this.parsePositiveInt(options.id, "id");
     const filterTypes = this.parseTypeFilter(options.type);
     const limit = parseLimit(options.limit);
     const activities = await collectPages({
@@ -29176,14 +29260,14 @@ class ActivityPRCommand extends BaseCommand {
       case "comment": {
         const content = getRawContent(activity.comment?.content) ?? "";
         const id = activity.comment?.id ? `#${activity.comment.id}` : "";
-        const snippet = this.truncate(content, 80);
+        const snippet = this.output.truncate(content, 80);
         return [id, snippet].filter(Boolean).join(" ");
       }
       case "approval":
         return "approved";
       case "changes_requested": {
         const reason = activity.changes_requested?.reason;
-        return reason ? this.truncate(reason, 80) : "changes requested";
+        return reason ? this.output.truncate(reason, 80) : "changes requested";
       }
       case "merge":
         return this.formatCommitDetail(activity.merge?.commit?.hash, "merged");
@@ -29196,7 +29280,7 @@ class ActivityPRCommand extends BaseCommand {
           return `state: ${activity.update.state}`;
         }
         if (activity.update?.title) {
-          return `title: ${this.truncate(activity.update.title, 60)}`;
+          return `title: ${this.output.truncate(activity.update.title, 60)}`;
         }
         if (activity.update?.description) {
           return "description updated";
@@ -29214,12 +29298,6 @@ class ActivityPRCommand extends BaseCommand {
     const shortHash = hash.slice(0, 7);
     return label ? `${label} ${shortHash}` : shortHash;
   }
-  truncate(text, maxLength) {
-    if (text.length <= maxLength) {
-      return text;
-    }
-    return text.substring(0, maxLength - 3) + "...";
-  }
 }
 
 // src/commands/pr/comment.command.ts
@@ -29253,33 +29331,14 @@ class CommentPRCommand extends BaseCommand {
         }
       });
     }
-    if (options.lineTo) {
-      const parsed = Number.parseInt(options.lineTo, 10);
-      if (Number.isNaN(parsed) || parsed < 1) {
-        throw new BBError({
-          code: 5002 /* VALIDATION_INVALID */,
-          message: "--line-to must be a positive integer"
-        });
-      }
-    }
-    if (options.lineFrom) {
-      const parsed = Number.parseInt(options.lineFrom, 10);
-      if (Number.isNaN(parsed) || parsed < 1) {
-        throw new BBError({
-          code: 5002 /* VALIDATION_INVALID */,
-          message: "--line-from must be a positive integer"
-        });
-      }
-    }
-    const repoContext = await this.contextService.requireRepoContext({
-      ...context.globalOptions,
-      ...options
-    });
-    const prId = Number.parseInt(options.id, 10);
+    const lineTo = options.lineTo ? this.parsePositiveInt(options.lineTo, "line-to") : undefined;
+    const lineFrom = options.lineFrom ? this.parsePositiveInt(options.lineFrom, "line-from") : undefined;
+    const repoContext = await this.contextService.requireRepoContextFor(options, context);
+    const prId = this.parsePositiveInt(options.id, "id");
     const inline = options.file ? {
       path: options.file,
-      ...options.lineTo ? { to: Number.parseInt(options.lineTo, 10) } : {},
-      ...options.lineFrom ? { from: Number.parseInt(options.lineFrom, 10) } : {}
+      ...lineTo !== undefined ? { to: lineTo } : {},
+      ...lineFrom !== undefined ? { from: lineFrom } : {}
     } : undefined;
     const body = {
       content: {
@@ -29329,11 +29388,8 @@ class ListCommentsPRCommand extends BaseCommand {
     this.contextService = contextService;
   }
   async execute(options, context) {
-    const repoContext = await this.contextService.requireRepoContext({
-      ...context.globalOptions,
-      ...options
-    });
-    const prId = this.parseIntOption(options.id, "id");
+    const repoContext = await this.contextService.requireRepoContextFor(options, context);
+    const prId = this.parsePositiveInt(options.id, "id");
     const limit = parseLimit(options.limit);
     const values = await collectPages({
       limit,
@@ -29350,6 +29406,8 @@ class ListCommentsPRCommand extends BaseCommand {
     });
     if (context.globalOptions.json) {
       await this.output.json({
+        workspace: repoContext.workspace,
+        repoSlug: repoContext.repoSlug,
         pullRequestId: prId,
         count: values.length,
         comments: values
@@ -29365,7 +29423,7 @@ class ListCommentsPRCommand extends BaseCommand {
       return [
         comment.id?.toString() ?? "",
         getUserDisplayName(comment.user) ?? "Unknown",
-        comment.deleted ? "[deleted]" : options.truncate === false ? content : content.slice(0, 60) + (content.length > 60 ? "..." : ""),
+        comment.deleted ? "[deleted]" : options.truncate === false ? content : this.output.truncate(content, 60),
         this.output.formatDate(comment.created_on ?? "")
       ];
     });
@@ -29385,12 +29443,9 @@ class EditCommentPRCommand extends BaseCommand {
     this.contextService = contextService;
   }
   async execute(options, context) {
-    const repoContext = await this.contextService.requireRepoContext({
-      ...context.globalOptions,
-      ...options
-    });
-    const prId = this.parseIntOption(options.prId, "pr-id");
-    const commentId = this.parseIntOption(options.commentId, "comment-id");
+    const repoContext = await this.contextService.requireRepoContextFor(options, context);
+    const prId = this.parsePositiveInt(options.prId, "pr-id");
+    const commentId = this.parsePositiveInt(options.commentId, "comment-id");
     const response = await this.pullrequestsApi.repositoriesWorkspaceRepoSlugPullrequestsPullRequestIdCommentsCommentIdPut({
       workspace: repoContext.workspace,
       repoSlug: repoContext.repoSlug,
@@ -29428,12 +29483,9 @@ class DeleteCommentPRCommand extends BaseCommand {
     this.contextService = contextService;
   }
   async execute(options, context) {
-    const repoContext = await this.contextService.requireRepoContext({
-      ...context.globalOptions,
-      ...options
-    });
-    const prId = this.parseIntOption(options.prId, "pr-id");
-    const commentId = this.parseIntOption(options.commentId, "comment-id");
+    const repoContext = await this.contextService.requireRepoContextFor(options, context);
+    const prId = this.parsePositiveInt(options.prId, "pr-id");
+    const commentId = this.parsePositiveInt(options.commentId, "comment-id");
     if (!options.yes) {
       throw new BBError({
         code: 5001 /* VALIDATION_REQUIRED */,
@@ -29473,11 +29525,8 @@ class AddReviewerPRCommand extends BaseCommand {
     this.contextService = contextService;
   }
   async execute(options, context) {
-    const repoContext = await this.contextService.requireRepoContext({
-      ...context.globalOptions,
-      ...options
-    });
-    const prId = this.parseIntOption(options.id, "id");
+    const repoContext = await this.contextService.requireRepoContextFor(options, context);
+    const prId = this.parsePositiveInt(options.id, "id");
     const userResponse = await this.usersApi.usersSelectedUserGet({
       selectedUser: options.username
     });
@@ -29518,11 +29567,8 @@ class RemoveReviewerPRCommand extends BaseCommand {
     this.contextService = contextService;
   }
   async execute(options, context) {
-    const repoContext = await this.contextService.requireRepoContext({
-      ...context.globalOptions,
-      ...options
-    });
-    const prId = this.parseIntOption(options.id, "id");
+    const repoContext = await this.contextService.requireRepoContextFor(options, context);
+    const prId = this.parsePositiveInt(options.id, "id");
     const userResponse = await this.usersApi.usersSelectedUserGet({
       selectedUser: options.username
     });
@@ -29556,11 +29602,8 @@ class ListReviewersPRCommand extends BaseCommand {
     this.contextService = contextService;
   }
   async execute(options, context) {
-    const repoContext = await this.contextService.requireRepoContext({
-      ...context.globalOptions,
-      ...options
-    });
-    const prId = this.parseIntOption(options.id, "id");
+    const repoContext = await this.contextService.requireRepoContextFor(options, context);
+    const prId = this.parsePositiveInt(options.id, "id");
     const response = await this.pullrequestsApi.repositoriesWorkspaceRepoSlugPullrequestsPullRequestIdGet({
       workspace: repoContext.workspace,
       repoSlug: repoContext.repoSlug,
@@ -29570,6 +29613,8 @@ class ListReviewersPRCommand extends BaseCommand {
     const reviewers = Array.from(pr.reviewers ?? []);
     if (context.globalOptions.json) {
       await this.output.json({
+        workspace: repoContext.workspace,
+        repoSlug: repoContext.repoSlug,
         pullRequestId: prId,
         count: reviewers.length,
         reviewers
@@ -29596,11 +29641,8 @@ class ChecksPRCommand extends BaseCommand {
     this.contextService = contextService;
   }
   async execute(options, context) {
-    const repoContext = await this.contextService.requireRepoContext({
-      ...context.globalOptions,
-      ...options
-    });
-    const prId = this.parseIntOption(options.id, "id");
+    const repoContext = await this.contextService.requireRepoContextFor(options, context);
+    const prId = this.parsePositiveInt(options.id, "id");
     const response = await this.commitStatusesApi.repositoriesWorkspaceRepoSlugPullrequestsPullRequestIdStatusesGet({
       workspace: repoContext.workspace,
       repoSlug: repoContext.repoSlug,
@@ -29654,7 +29696,7 @@ class ChecksPRCommand extends BaseCommand {
       return [
         `${stateIcon} ${stateLabel}`,
         this.output.bold(name),
-        this.truncate(description, 40),
+        this.output.truncate(description, 40),
         status.updated_on ? this.output.formatDate(status.updated_on) : "-"
       ];
     });
@@ -29704,12 +29746,6 @@ class ChecksPRCommand extends BaseCommand {
       return acc;
     }, { successful: 0, failed: 0, pending: 0 });
   }
-  truncate(text, maxLength) {
-    if (text.length <= maxLength) {
-      return text;
-    }
-    return text.substring(0, maxLength - 3) + "...";
-  }
 }
 
 // src/commands/snippet/list.command.ts
@@ -30122,7 +30158,7 @@ class ListSnippetCommentsCommand extends BaseCommand {
         String(comment.id ?? ""),
         getUserDisplayName(comment.user) ?? "Unknown",
         this.output.formatDate(comment.created_on ?? ""),
-        content.slice(0, 60) + (content.length > 60 ? "..." : "")
+        this.output.truncate(content, 60)
       ];
     });
     this.output.table(["ID", "AUTHOR", "DATE", "CONTENT"], rows);
@@ -30181,7 +30217,7 @@ class EditSnippetCommentCommand extends BaseCommand {
   }
   async execute(options, context) {
     const workspace = await this.contextService.requireWorkspace(options.workspace ?? context.globalOptions.workspace);
-    const commentId = this.parseIntOption(options.commentId, "comment-id");
+    const commentId = this.parsePositiveInt(options.commentId, "comment-id");
     const body = {
       type: "snippet_comment",
       content: {
@@ -30219,7 +30255,7 @@ class DeleteSnippetCommentCommand extends BaseCommand {
   }
   async execute(options, context) {
     const workspace = await this.contextService.requireWorkspace(options.workspace ?? context.globalOptions.workspace);
-    const commentId = this.parseIntOption(options.commentId, "comment-id");
+    const commentId = this.parsePositiveInt(options.commentId, "comment-id");
     if (!options.yes) {
       throw new BBError({
         code: 5001 /* VALIDATION_REQUIRED */,
@@ -30451,6 +30487,179 @@ class UninstallCompletionCommand extends BaseCommand {
   }
 }
 
+// src/commands/browse.command.ts
+var SHA_PATTERN = /^[0-9a-f]{7,40}$/i;
+var PR_NUMBER_PATTERN = /^\d+$/;
+var PATH_LINE_PATTERN = /^(.+):(\d+)$/;
+
+class BrowseCommand extends BaseCommand {
+  contextService;
+  gitService;
+  urlBuilder;
+  name = "browse";
+  description = "Open a Bitbucket page (repo, file, PR, commit, etc.) in your browser";
+  constructor(contextService, gitService, urlBuilder, output) {
+    super(output);
+    this.contextService = contextService;
+    this.gitService = gitService;
+    this.urlBuilder = urlBuilder;
+  }
+  async execute(options, context) {
+    const repoContext = await this.contextService.requireRepoContextFor(options, context);
+    this.validateFlagCombination(options);
+    const url2 = await this.resolveUrl(options, repoContext);
+    const useJson = Boolean(context.globalOptions.json);
+    const printOnly = options.browser === false;
+    if (useJson) {
+      await this.output.json({ url: url2 });
+      return { url: url2, opened: false };
+    }
+    if (printOnly) {
+      this.output.text(url2);
+      return { url: url2, opened: false };
+    }
+    await this.openInBrowser(url2);
+    return { url: url2, opened: true };
+  }
+  async resolveUrl(options, ctx) {
+    if (options.pr !== undefined) {
+      return this.urlBuilder.pullRequest(ctx, this.parsePositiveInt(options.pr, "pr"));
+    }
+    if (options.prs || options.pullRequests) {
+      return this.urlBuilder.pullRequestList(ctx);
+    }
+    if (options.branches) {
+      return this.urlBuilder.branchList(ctx);
+    }
+    if (options.commits) {
+      return this.urlBuilder.commitList(ctx);
+    }
+    if (options.commit !== undefined) {
+      const sha = typeof options.commit === "string" && options.commit.length > 0 ? options.commit : await this.gitService.getCurrentCommit();
+      return this.urlBuilder.commit(ctx, sha);
+    }
+    if (options.pipelines) {
+      return this.urlBuilder.pipelinesHome(ctx);
+    }
+    if (options.pipeline !== undefined) {
+      const value = options.pipeline.trim();
+      if (value.length === 0) {
+        throw new BBError({
+          code: 5002 /* VALIDATION_INVALID */,
+          message: this.appendHelpHint("--pipeline requires a run id or uuid.")
+        });
+      }
+      return this.urlBuilder.pipelineRun(ctx, value);
+    }
+    if (options.downloads) {
+      return this.urlBuilder.downloads(ctx);
+    }
+    if (options.issue !== undefined) {
+      return this.urlBuilder.issue(ctx, this.parsePositiveInt(options.issue, "issue"));
+    }
+    if (options.issues) {
+      return this.urlBuilder.issueList(ctx);
+    }
+    if (options.wiki) {
+      return this.urlBuilder.wiki(ctx);
+    }
+    if (options.settings) {
+      return this.urlBuilder.settings(ctx);
+    }
+    const target = options.target?.trim();
+    if (target && target.length > 0) {
+      if (PR_NUMBER_PATTERN.test(target)) {
+        return this.urlBuilder.pullRequest(ctx, this.parsePositiveInt(target, "target"));
+      }
+      if (SHA_PATTERN.test(target)) {
+        return this.urlBuilder.commit(ctx, target);
+      }
+      const { path: path3, line } = this.parsePathWithLine(target);
+      const branch = await this.resolveBranch(options.branch);
+      return this.urlBuilder.src(ctx, branch, path3, line);
+    }
+    if (options.branch) {
+      return this.urlBuilder.src(ctx, options.branch);
+    }
+    return this.urlBuilder.repo(ctx);
+  }
+  validateFlagCombination(options) {
+    const setFlags = [];
+    if (options.pr !== undefined)
+      setFlags.push("--pr");
+    if (options.prs) {
+      setFlags.push("--prs");
+    } else if (options.pullRequests) {
+      setFlags.push("--pull-requests");
+    }
+    if (options.branches)
+      setFlags.push("--branches");
+    if (options.commit !== undefined)
+      setFlags.push("--commit");
+    if (options.commits)
+      setFlags.push("--commits");
+    if (options.pipelines)
+      setFlags.push("--pipelines");
+    if (options.pipeline !== undefined)
+      setFlags.push("--pipeline");
+    if (options.downloads)
+      setFlags.push("--downloads");
+    if (options.issue !== undefined)
+      setFlags.push("--issue");
+    if (options.issues)
+      setFlags.push("--issues");
+    if (options.wiki)
+      setFlags.push("--wiki");
+    if (options.settings)
+      setFlags.push("--settings");
+    if (setFlags.length > 1) {
+      throw new BBError({
+        code: 5002 /* VALIDATION_INVALID */,
+        message: this.appendHelpHint(`Cannot combine ${setFlags.join(" and ")}; pick one resource.`)
+      });
+    }
+    const hasResourceFlag = setFlags.length === 1;
+    const hasTarget = !!options.target?.trim();
+    if (hasResourceFlag && hasTarget) {
+      throw new BBError({
+        code: 5002 /* VALIDATION_INVALID */,
+        message: this.appendHelpHint(`Cannot use a positional target with ${setFlags[0]}.`)
+      });
+    }
+    if (hasResourceFlag && options.branch) {
+      throw new BBError({
+        code: 5002 /* VALIDATION_INVALID */,
+        message: this.appendHelpHint(`Cannot combine --branch with ${setFlags[0]}.`)
+      });
+    }
+  }
+  parsePathWithLine(target) {
+    const match = PATH_LINE_PATTERN.exec(target);
+    if (match) {
+      const line = Number.parseInt(match[2], 10);
+      if (Number.isFinite(line) && line > 0) {
+        return { path: match[1], line };
+      }
+    }
+    return { path: target };
+  }
+  async resolveBranch(explicit) {
+    if (explicit && explicit.length > 0) {
+      return explicit;
+    }
+    try {
+      return await this.gitService.getCurrentBranch();
+    } catch {
+      return "HEAD";
+    }
+  }
+  async openInBrowser(url2) {
+    this.output.info(`Opening ${url2} in your browser...`);
+    const open2 = (await Promise.resolve().then(() => (init_open(), exports_open))).default;
+    await open2(url2);
+  }
+}
+
 // src/bootstrap.ts
 var require2 = createRequire(import.meta.url);
 var pkg = require2("../package.json");
@@ -30497,6 +30706,7 @@ function bootstrap(options = {}) {
   });
   registerCommand(container, ServiceTokens.SnippetFilesService, SnippetFilesService, [ServiceTokens.SnippetsAxios]);
   registerCommand(container, ServiceTokens.DefaultReviewerService, DefaultReviewerService, [ServiceTokens.PullrequestsApi]);
+  container.register(ServiceTokens.UrlBuilderService, () => new UrlBuilderService);
   registerCommand(container, ServiceTokens.LoginCommand, LoginCommand, [
     ServiceTokens.CredentialStore,
     ServiceTokens.UsersApi,
@@ -30731,6 +30941,12 @@ function bootstrap(options = {}) {
     ServiceTokens.OutputService
   ]);
   registerCommand(container, ServiceTokens.ListConfigCommand, ListConfigCommand, [ServiceTokens.ConfigService, ServiceTokens.OutputService]);
+  registerCommand(container, ServiceTokens.BrowseCommand, BrowseCommand, [
+    ServiceTokens.ContextService,
+    ServiceTokens.GitService,
+    ServiceTokens.UrlBuilderService,
+    ServiceTokens.OutputService
+  ]);
   registerCommand(container, ServiceTokens.InstallCompletionCommand, InstallCompletionCommand, [ServiceTokens.OutputService]);
   registerCommand(container, ServiceTokens.UninstallCompletionCommand, UninstallCompletionCommand, [ServiceTokens.OutputService]);
   container.register(ServiceTokens.VersionService, () => {
@@ -30820,6 +31036,7 @@ var ROOT_COMPLETIONS = [
   "repo",
   "pr",
   "snippet",
+  "browse",
   "config",
   "completion",
   "--help",
@@ -31021,7 +31238,7 @@ cli.name("bb").description("A command-line interface for Bitbucket Cloud").versi
   } catch {}
 });
 var authCmd = new Command("auth").description("Authenticate with Bitbucket");
-authCmd.command("login").description("Authenticate with Bitbucket (OAuth or API token)").option("-u, --username <username>", "Bitbucket username (implies API token auth)").option("-p, --password <password>", "Bitbucket API token (implies API token auth)").option("--app-password", "Use API token authentication instead of OAuth").option("--client-id <clientId>", "Custom OAuth consumer client ID").option("--client-secret <clientSecret>", "Custom OAuth consumer client secret").addHelpText("before", `
+authCmd.command("login").description("Authenticate with Bitbucket (OAuth or API token)").option("-u, --username <username>", "Bitbucket username (implies API token auth)").option("-p, --password <password>", "Bitbucket API token (implies API token auth)").option("--app-password", "Use API token authentication (instead of OAuth). App passwords are deprecated; use API tokens.").option("--client-id <clientId>", "Custom OAuth consumer client ID").option("--client-secret <clientSecret>", "Custom OAuth consumer client secret").addHelpText("before", `
 Default: OAuth (browser-based, recommended).
 ` + `For CI/CD: API token via --app-password or BB_API_TOKEN env var.
 ` + `Note: Bitbucket app passwords are deprecated; use OAuth or an API token.
@@ -31164,7 +31381,7 @@ prCmd.command("create").description("Create a pull request").option("-t, --title
   const context = createContext(cli);
   await runCommand(ServiceTokens.CreatePRCommand, withGlobalOptions(options, context), cli, context);
 });
-prCmd.command("list").description("List pull requests").option("-s, --state <state>", `Filter by state (${PR_STATES.join(", ")})`, "OPEN").option("--limit <number>", "Maximum number of PRs to list", "25").option("--mine", "Show only PRs where you are a reviewer").addHelpText("after", buildHelpText({
+prCmd.command("list").description("List pull requests").option("-s, --state <state>", `Filter by state (${PR_STATES.join(", ")})`, "OPEN").option("--limit <number>", "Maximum number of PRs to list", "25").option("--mine", "Show only PRs where you are a reviewer (not authored by you)").addHelpText("after", buildHelpText({
   examples: [
     "bb pr list",
     "bb pr list -s MERGED --limit 10",
@@ -31358,23 +31575,23 @@ prReviewersCmd.command("list <id>").description("List reviewers on a pull reques
   const context = createContext(cli);
   await runCommand(ServiceTokens.ListReviewersPRCommand, withGlobalOptions({ id, ...options }, context), cli, context);
 });
-prReviewersCmd.command("add <id> <username>").description("Add a reviewer to a pull request").addHelpText("after", buildHelpText({
+prReviewersCmd.command("add <id> <user>").description("Add a reviewer to a pull request (user is an account ID or {uuid})").addHelpText("after", buildHelpText({
   examples: [
     'bb pr reviewers add 42 "712020:3cfed7e0-0ed6-49fc-bb35-410a00ccee6f"',
     'bb pr reviewers add 42 "{c1cb1bb5-2e32-456e-a373-43978dc12aa1}"'
   ]
-})).action(async (id, username, options) => {
+})).action(async (id, user, options) => {
   const context = createContext(cli);
-  await runCommand(ServiceTokens.AddReviewerPRCommand, withGlobalOptions({ id, username, ...options }, context), cli, context);
+  await runCommand(ServiceTokens.AddReviewerPRCommand, withGlobalOptions({ id, username: user, ...options }, context), cli, context);
 });
-prReviewersCmd.command("remove <id> <username>").description("Remove a reviewer from a pull request").addHelpText("after", buildHelpText({
+prReviewersCmd.command("remove <id> <user>").description("Remove a reviewer from a pull request (user is an account ID or {uuid})").addHelpText("after", buildHelpText({
   examples: [
     'bb pr reviewers remove 42 "712020:3cfed7e0-0ed6-49fc-bb35-410a00ccee6f"',
     'bb pr reviewers remove 42 "{c1cb1bb5-2e32-456e-a373-43978dc12aa1}"'
   ]
-})).action(async (id, username, options) => {
+})).action(async (id, user, options) => {
   const context = createContext(cli);
-  await runCommand(ServiceTokens.RemoveReviewerPRCommand, withGlobalOptions({ id, username, ...options }, context), cli, context);
+  await runCommand(ServiceTokens.RemoveReviewerPRCommand, withGlobalOptions({ id, username: user, ...options }, context), cli, context);
 });
 cli.addCommand(prCmd);
 prCmd.addCommand(prCommentsCmd);
@@ -31405,7 +31622,7 @@ snippetCmd.command("view <id>").description("View snippet details").option("-f,
   const context = createContext(cli);
   await runCommand(ServiceTokens.ViewSnippetCommand, withGlobalOptions({ id, ...options }, context), cli, context);
 });
-snippetCmd.command("create").description("Create a new snippet").option("-t, --title <title>", "Snippet title").option("-f, --file <path...>", "File(s) to include").option("--private", "Create a private snippet (default)").option("--public", "Create a public snippet").addHelpText("after", buildHelpText({
+snippetCmd.command("create").description("Create a new snippet").option("-t, --title <title>", "Snippet title").option("-f, --file <path...>", "File(s) to include (variadic; pass multiple paths or repeat the flag)").option("--private", "Create a private snippet (default)").option("--public", "Create a public snippet").addHelpText("after", buildHelpText({
   examples: [
     'bb snippet create -t "My snippet" -f file.txt',
     'bb snippet create -t "Config files" -f config.yml -f setup.sh --public'
@@ -31415,7 +31632,7 @@ snippetCmd.command("create").description("Create a new snippet").option("-t, --t
   const context = createContext(cli);
   await runCommand(ServiceTokens.CreateSnippetCommand, withGlobalOptions(options, context), cli, context);
 });
-snippetCmd.command("edit <id>").description("Edit a snippet").option("-t, --title <title>", "New snippet title").option("--private", "Make snippet private").option("--public", "Make snippet public").option("-f, --file <path...>", "Replace/add file(s) (sends multipart update)").addHelpText("after", buildHelpText({
+snippetCmd.command("edit <id>").description("Edit a snippet").option("-t, --title <title>", "New snippet title").option("--private", "Make snippet private").option("--public", "Make snippet public").option("-f, --file <path...>", "Replace/add file(s) (variadic; pass multiple paths or repeat the flag; sends multipart update)").addHelpText("after", buildHelpText({
   examples: [
     'bb snippet edit kypj -t "New title"',
     "bb snippet edit kypj --public",
@@ -31488,6 +31705,26 @@ snippetCommentsCmd.command("delete <snippet-id> <comment-id>").description("Dele
 });
 snippetCmd.addCommand(snippetCommentsCmd);
 cli.addCommand(snippetCmd);
+cli.command("browse [target]").description("Open a Bitbucket page (repo home, file, PR, commit, etc.) in your browser").option("--pr <id>", "Open a specific pull request").option("--prs", "Open the pull-requests list").option("--pull-requests", "Alias for --prs").option("--branch <name>", "Open the branch source tree (or, with <target>, that path on the branch)").option("--branches", "Open the branches list").option("--commit [sha]", "Open a specific commit (defaults to HEAD when no SHA is given)").option("--commits", "Open the commits list").option("--pipelines", "Open the pipelines page").option("--pipeline <id>", "Open a specific pipeline run").option("--downloads", "Open the downloads page").option("--issue <id>", "Open a specific issue").option("--issues", "Open the issue tracker").option("--wiki", "Open the wiki").option("--settings", "Open repository settings").option("-n, --no-browser", "Print the URL to stdout instead of opening it").addHelpText("after", buildHelpText({
+  examples: [
+    "bb browse",
+    "bb browse src/cli.ts",
+    "bb browse src/cli.ts:42",
+    "bb browse --branch release/2.0 src/cli.ts",
+    "bb browse 217",
+    "bb browse --pr 217",
+    "bb browse --prs",
+    "bb browse abc1234",
+    "bb browse --commit",
+    "bb browse --pipelines",
+    "bb browse --settings",
+    "bb browse --pr 217 --no-browser",
+    "bb browse --pr 217 --json url"
+  ]
+})).action(async (target, options) => {
+  const context = createContext(cli);
+  await runCommand(ServiceTokens.BrowseCommand, withGlobalOptions({ target, ...options }, context), cli, context);
+});
 var configCmd = new Command("config").description("Manage configuration");
 configCmd.command("get <key>").description("Get a configuration value").addHelpText("after", buildHelpText({
   examples: ["bb config get defaultWorkspace"],
@@ -31560,3 +31797,6 @@ if (typeof Bun === "undefined") {
   process.exit(1);
 }
 cli.parse(process.argv);
+
+//# debugId=A7729A51C3738B3664756E2164756E21
+//# sourceMappingURL=index.js.map