@pilatos/bitbucket-cli 1.0.0 → 1.2.0

package/README.md

@@ -32,56 +32,20 @@
 
 If you've used GitHub's `gh` CLI and loved it, you've probably wished for something similar for Bitbucket. **Now you have it.**
 
-`bb` brings the power of command-line workflows to Bitbucket Cloud, letting you:
-
 - **Stay in your terminal** — No more context-switching to the browser
-- **Automate your workflow** — Script common operations with ease
+- **Automate your workflow** — Script common operations with JSON output
 - **Work faster** — Clone repos, create PRs, and manage code reviews in seconds
-- **Maintain consistency** — Use familiar patterns if you work across GitHub and Bitbucket
-
----
-
-## Table of Contents
-
-- [Installation](#installation)
-- [Quick Start](#quick-start)
-- [Commands](#commands)
-  - [Authentication](#authentication)
-  - [Repositories](#repositories)
-  - [Pull Requests](#pull-requests)
-  - [Configuration](#configuration)
-  - [Shell Completion](#shell-completion)
-- [Global Options](#global-options)
-- [Authentication Setup](#authentication-setup)
-- [Configuration](#configuration-1)
-- [Examples](#examples)
-- [Development](#development)
-- [Contributing](#contributing)
-- [License](#license)
+- **Smart context detection** — Automatically detects workspace/repo from git directory
 
 ---
 
 ## Installation
 
-### Using npm (Recommended)
-
 ```bash
 npm install -g @pilatos/bitbucket-cli
 ```
 
-### Using Bun
-
-```bash
-bun install -g @pilatos/bitbucket-cli
-```
-
-### Using Yarn
-
-```bash
-yarn global add @pilatos/bitbucket-cli
-```
-
-### Verify Installation
+Verify installation:
 
 ```bash
 bb --version
@@ -93,21 +57,19 @@ bb --version
 
 ## Quick Start
 
-Get up and running in under a minute:
-
 ```bash
 # 1. Authenticate with Bitbucket
 bb auth login
 
 # 2. Clone a repository
 bb repo clone myworkspace/myrepo
+cd myrepo
 
 # 3. Create a feature branch and make changes
-cd myrepo
 git checkout -b feature/awesome-feature
 
 # 4. Create a pull request
-bb pr create --title "Add awesome feature" --source feature/awesome-feature --destination main
+bb pr create --title "Add awesome feature"
 
 # 5. List open pull requests
 bb pr list
@@ -115,156 +77,55 @@ bb pr list
 
 ---
 
-## Commands
-
-### Authentication
-
-Manage your Bitbucket authentication securely.
-
-| Command | Description |
-|---------|-------------|
-| `bb auth login` | Authenticate with Bitbucket using an API Token |
-| `bb auth logout` | Log out and remove stored credentials |
-| `bb auth status` | Check your current authentication status |
-| `bb auth token` | Print your current access token |
-
-### Repositories
-
-Clone, create, and manage your Bitbucket repositories.
-
-| Command | Description |
-|---------|-------------|
-| `bb repo clone <repo>` | Clone a repository to your local machine |
-| `bb repo create <name>` | Create a new repository |
-| `bb repo list` | List repositories in a workspace |
-| `bb repo view [repo]` | View repository details and metadata |
-| `bb repo delete <repo>` | Delete a repository (use with caution!) |
-
-### Pull Requests
-
-Full pull request workflow management from your terminal.
-
-| Command | Description |
-|---------|-------------|
-| `bb pr create` | Create a new pull request |
-| `bb pr list` | List pull requests with filtering options |
-| `bb pr view <id>` | View pull request details, diff, and comments |
-| `bb pr merge <id>` | Merge a pull request |
-| `bb pr approve <id>` | Approve a pull request |
-| `bb pr decline <id>` | Decline a pull request |
-| `bb pr checkout <id>` | Checkout a pull request branch locally |
-
-### Configuration
-
-Customize your CLI experience.
-
-| Command | Description |
-|---------|-------------|
-| `bb config get <key>` | Get a configuration value |
-| `bb config set <key> <value>` | Set a configuration value |
-| `bb config list` | List all configuration values |
-
-### Shell Completion
-
-Enable intelligent tab completion for faster command entry.
-
-| Command | Description |
-|---------|-------------|
-| `bb completion install` | Install shell completions (auto-detects shell) |
-| `bb completion uninstall` | Remove shell completions |
-
-**Setup:**
-
-```bash
-# Install completions
-bb completion install
-
-# Restart your shell or source your profile
-source ~/.bashrc    # Bash
-source ~/.zshrc     # Zsh
-source ~/.config/fish/config.fish  # Fish
-```
+## Features
 
-**Usage:**
+| Category | Commands |
+|----------|----------|
+| **Authentication** | `login`, `logout`, `status`, `token` |
+| **Repositories** | `clone`, `create`, `list`, `view`, `delete` |
+| **Pull Requests** | `create`, `list`, `view`, `edit`, `merge`, `approve`, `decline`, `checkout`, `diff`, `comment`, `comments` |
+| **Configuration** | `get`, `set`, `list` |
+| **Shell Completion** | `install`, `uninstall` |
 
-```bash
-bb re<Tab>        # → bb repo
-bb repo cl<Tab>   # → bb repo clone
-bb pr l<Tab>      # → bb pr list
-```
+**Global Options:**
+- `--json` — Output results as JSON for scripting
+- `-w, --workspace` — Specify workspace
+- `-r, --repo` — Specify repository
 
 ---
 
-## Global Options
+## Documentation
 
-These options work with any command:
+Full documentation is available at **[bitbucket-cli.paulvanderlei.com](https://bitbucket-cli.paulvanderlei.com)**
 
-| Option | Description |
-|--------|-------------|
-| `--json` | Output results as JSON for scripting |
-| `-w, --workspace <workspace>` | Specify the workspace (overrides default) |
-| `-r, --repo <repo>` | Specify the repository (overrides default) |
-| `-h, --help` | Show help information |
-| `-v, --version` | Show version number |
+- [Quick Start Guide](https://bitbucket-cli.paulvanderlei.com/getting-started/quickstart/)
+- [Command Reference](https://bitbucket-cli.paulvanderlei.com/commands/auth/)
+- [Scripting & Automation](https://bitbucket-cli.paulvanderlei.com/guides/scripting/)
+- [CI/CD Integration](https://bitbucket-cli.paulvanderlei.com/guides/cicd/)
+- [Troubleshooting](https://bitbucket-cli.paulvanderlei.com/help/troubleshooting/)
+- [FAQ](https://bitbucket-cli.paulvanderlei.com/help/faq/)
 
 ---
 
-## Authentication Setup
+## Authentication
 
-The CLI uses **Bitbucket API Tokens** for secure authentication. Here's how to set it up:
+The CLI uses **Bitbucket API Tokens** for secure authentication.
 
-> **Note**: As of September 9, 2025, Bitbucket app passwords are deprecated and can no longer be created. All existing app passwords will be disabled on June 9, 2026. Use API tokens instead.
+> **Note**: As of September 9, 2025, Bitbucket app passwords are deprecated. Use API tokens instead.
 
-### Step 1: Create an API Token
+### Create an API Token
 
 1. Go to [Bitbucket API Tokens](https://bitbucket.org/account/settings/api-tokens/)
 2. Click **"Create API token"**
-3. Enter a descriptive label (e.g., "bb CLI")
-4. Select the required scopes:
-   - **Account:** Read
-   - **Repositories:** Read, Write, Admin (as needed)
-   - **Pull requests:** Read, Write
-5. Click **"Create"**
-6. **Copy the generated token** (you won't see it again!)
+3. Select required scopes (Account, Repositories, Pull requests)
+4. Copy the token
 
-### Step 2: Authenticate
+### Authenticate
 
 ```bash
 bb auth login
 ```
 
-Enter your Bitbucket username and the API Token when prompted.
-
-### Step 3: Verify
-
-```bash
-bb auth status
-```
-
----
-
-## Configuration
-
-Configuration files are stored in platform-specific locations:
-
-| Platform | Location |
-|----------|----------|
-| **macOS / Linux** | `~/.config/bb/config.json` |
-| **Windows** | `%APPDATA%\bb\config.json` |
-
-### Available Settings
-
-```bash
-# Set your default workspace
-bb config set workspace myworkspace
-
-# Set your default repository
-bb config set repo myrepo
-
-# View all settings
-bb config list
-```
-
 ---
 
 ## Examples
@@ -272,53 +133,38 @@ bb config list
 ### Daily Workflow
 
 ```bash
-# Start your day: check open PRs assigned to you
-bb pr list --state OPEN
+# Check open PRs
+bb pr list
 
-# Review a specific PR
+# Review and merge
 bb pr view 42
-
-# Approve and merge
 bb pr approve 42
 bb pr merge 42
 ```
 
-### Creating a Pull Request
+### Scripting with JSON
 
 ```bash
-# From your feature branch
-bb pr create \
-  --title "feat: Add user notifications" \
-  --description "Implements real-time notifications using WebSockets" \
-  --source feature/notifications \
-  --destination main
-```
+# Get all open PR titles
+bb pr list --json | jq '.[].title'
 
-### Scripting with JSON Output
-
-```bash
-# Get all open PRs as JSON for processing
-bb pr list --state OPEN --json | jq '.[] | .title'
-
-# List repos and filter by name
+# Filter repos by name
 bb repo list --json | jq '.[] | select(.name | contains("api"))'
 ```
 
-### Quick Repository Setup
+### CI/CD Usage
 
 ```bash
-# Create and clone a new repo in one flow
-bb repo create my-new-project
-bb repo clone myworkspace/my-new-project
-cd my-new-project
+export BB_USERNAME=myuser
+export BB_API_TOKEN=my-token
+bb auth login
+bb pr list -w workspace -r repo --json
 ```
 
 ---
 
 ## Development
 
-Want to contribute or run locally? Here's how:
-
 ```bash
 # Clone the repository
 git clone https://github.com/0pilatos0/bitbucket-cli.git
@@ -335,59 +181,33 @@ bun test
 
 # Build for production
 bun run build
-
-# Generate API client from OpenAPI spec
-bun run generate:api
-```
-
-### Project Structure
-
-```
-bitbucket-cli/
-├── src/
-│   ├── commands/      # Command implementations
-│   ├── core/          # Core utilities and base classes
-│   └── index.ts       # Entry point
-├── tests/             # Test files
-├── docs/              # Documentation site (Astro)
-└── specs/             # OpenAPI specifications
 ```
 
 ---
 
 ## Contributing
 
-We welcome contributions from the community! Whether it's:
-
-- Reporting bugs
-- Suggesting new features
-- Improving documentation
-- Submitting pull requests
-
-Please read our [Contributing Guide](CONTRIBUTING.md) to get started.
-
-### Quick Contribution Steps
+We welcome contributions! Please read our [Contributing Guide](CONTRIBUTING.md) to get started.
 
 1. Fork the repository
-2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+2. Create a feature branch
 3. Make your changes
 4. Run tests (`bun test`)
-5. Commit with a descriptive message
-6. Push and open a Pull Request
+5. Submit a Pull Request
 
 ---
 
 ## Acknowledgments
 
-- Inspired by [GitHub CLI (`gh`)](https://cli.github.com/) — the gold standard for repository CLIs
-- Built with [Commander.js](https://github.com/tj/commander.js) for robust command parsing
+- Inspired by [GitHub CLI (`gh`)](https://cli.github.com/)
+- Built with [Commander.js](https://github.com/tj/commander.js)
 - Uses the [Bitbucket Cloud REST API](https://developer.atlassian.com/cloud/bitbucket/rest/)
 
 ---
 
 ## License
 
-This project is licensed under the **MIT License** — see the [LICENSE](LICENSE) file for details.
+MIT License — see [LICENSE](LICENSE) for details.
 
 ---
 

package/dist/index.js

@@ -27629,7 +27629,7 @@ var require_iso2022 = __commonJS((exports, module) => {
 
 // node_modules/external-editor/node_modules/chardet/index.js
 var require_chardet = __commonJS((exports, module) => {
-  var fs = __require("fs");
+  var fs2 = __require("fs");
   var utf8 = require_utf8();
   var unicode = require_unicode();
   var mbcs = require_mbcs();
@@ -27703,29 +27703,29 @@ var require_chardet = __commonJS((exports, module) => {
     var fd;
     var handler = function(err, buffer) {
       if (fd) {
-        fs.closeSync(fd);
+        fs2.closeSync(fd);
       }
       if (err)
         return cb(err, null);
       cb(null, self2.detect(buffer, opts));
     };
     if (opts && opts.sampleSize) {
-      fd = fs.openSync(filepath, "r"), sample = Buffer.allocUnsafe(opts.sampleSize);
-      fs.read(fd, sample, 0, opts.sampleSize, null, function(err) {
+      fd = fs2.openSync(filepath, "r"), sample = Buffer.allocUnsafe(opts.sampleSize);
+      fs2.read(fd, sample, 0, opts.sampleSize, null, function(err) {
         handler(err, sample);
       });
       return;
     }
-    fs.readFile(filepath, handler);
+    fs2.readFile(filepath, handler);
   };
   module.exports.detectFileSync = function(filepath, opts) {
     if (opts && opts.sampleSize) {
-      var fd = fs.openSync(filepath, "r"), sample2 = Buffer.allocUnsafe(opts.sampleSize);
-      fs.readSync(fd, sample2, 0, opts.sampleSize);
-      fs.closeSync(fd);
+      var fd = fs2.openSync(filepath, "r"), sample2 = Buffer.allocUnsafe(opts.sampleSize);
+      fs2.readSync(fd, sample2, 0, opts.sampleSize);
+      fs2.closeSync(fd);
       return self2.detect(sample2, opts);
     }
-    return self2.detect(fs.readFileSync(filepath), opts);
+    return self2.detect(fs2.readFileSync(filepath), opts);
   };
   module.exports.detectAll = function(buffer, opts) {
     if (typeof opts !== "object") {
@@ -31087,7 +31087,7 @@ var require_tmp = __commonJS((exports, module) => {
    *
    * MIT Licensed
    */
-  var fs = __require("fs");
+  var fs2 = __require("fs");
   var path = __require("path");
   var crypto = __require("crypto");
   var osTmpDir = require_os_tmpdir();
@@ -31151,7 +31151,7 @@ var require_tmp = __commonJS((exports, module) => {
       return cb(new Error("Invalid template provided"));
     (function _getUniqueName() {
       const name = _generateTmpName(opts);
-      fs.stat(name, function(err) {
+      fs2.stat(name, function(err) {
         if (!err) {
           if (tries-- > 0)
             return _getUniqueName();
@@ -31170,7 +31170,7 @@ var require_tmp = __commonJS((exports, module) => {
     do {
       const name = _generateTmpName(opts);
       try {
-        fs.statSync(name);
+        fs2.statSync(name);
       } catch (e) {
         return name;
       }
@@ -31183,14 +31183,14 @@ var require_tmp = __commonJS((exports, module) => {
     tmpName(opts, function _tmpNameCreated(err, name) {
       if (err)
         return cb(err);
-      fs.open(name, CREATE_FLAGS, opts.mode || FILE_MODE, function _fileCreated(err2, fd) {
+      fs2.open(name, CREATE_FLAGS, opts.mode || FILE_MODE, function _fileCreated(err2, fd) {
         if (err2)
           return cb(err2);
         if (opts.discardDescriptor) {
-          return fs.close(fd, function _discardCallback(err3) {
+          return fs2.close(fd, function _discardCallback(err3) {
             if (err3) {
               try {
-                fs.unlinkSync(name);
+                fs2.unlinkSync(name);
               } catch (e) {
                 if (!isENOENT(e)) {
                   err3 = e;
@@ -31213,9 +31213,9 @@ var require_tmp = __commonJS((exports, module) => {
     opts.postfix = opts.postfix || ".tmp";
     const discardOrDetachDescriptor = opts.discardDescriptor || opts.detachDescriptor;
     const name = tmpNameSync(opts);
-    var fd = fs.openSync(name, CREATE_FLAGS, opts.mode || FILE_MODE);
+    var fd = fs2.openSync(name, CREATE_FLAGS, opts.mode || FILE_MODE);
     if (opts.discardDescriptor) {
-      fs.closeSync(fd);
+      fs2.closeSync(fd);
       fd = undefined;
     }
     return {
@@ -31227,9 +31227,9 @@ var require_tmp = __commonJS((exports, module) => {
   function _rmdirRecursiveSync(root) {
     const dirs = [root];
     do {
-      var dir2 = dirs.pop(), deferred = false, files = fs.readdirSync(dir2);
+      var dir2 = dirs.pop(), deferred = false, files = fs2.readdirSync(dir2);
       for (var i = 0, length = files.length;i < length; i++) {
-        var file2 = path.join(dir2, files[i]), stat = fs.lstatSync(file2);
+        var file2 = path.join(dir2, files[i]), stat = fs2.lstatSync(file2);
         if (stat.isDirectory()) {
           if (!deferred) {
             deferred = true;
@@ -31237,11 +31237,11 @@ var require_tmp = __commonJS((exports, module) => {
           }
           dirs.push(file2);
         } else {
-          fs.unlinkSync(file2);
+          fs2.unlinkSync(file2);
         }
       }
       if (!deferred) {
-        fs.rmdirSync(dir2);
+        fs2.rmdirSync(dir2);
       }
     } while (dirs.length !== 0);
   }
@@ -31250,7 +31250,7 @@ var require_tmp = __commonJS((exports, module) => {
     tmpName(opts, function _tmpNameCreated(err, name) {
       if (err)
         return cb(err);
-      fs.mkdir(name, opts.mode || DIR_MODE, function _dirCreated(err2) {
+      fs2.mkdir(name, opts.mode || DIR_MODE, function _dirCreated(err2) {
         if (err2)
           return cb(err2);
         cb(null, name, _prepareTmpDirRemoveCallback(name, opts));
@@ -31260,7 +31260,7 @@ var require_tmp = __commonJS((exports, module) => {
   function dirSync(options) {
     var args = _parseArguments(options), opts = args[0];
     const name = tmpNameSync(opts);
-    fs.mkdirSync(name, opts.mode || DIR_MODE);
+    fs2.mkdirSync(name, opts.mode || DIR_MODE);
     return {
       name,
       removeCallback: _prepareTmpDirRemoveCallback(name, opts)
@@ -31270,7 +31270,7 @@ var require_tmp = __commonJS((exports, module) => {
     const removeCallback = _prepareRemoveCallback(function _removeCallback(fdPath) {
       try {
         if (0 <= fdPath[0]) {
-          fs.closeSync(fdPath[0]);
+          fs2.closeSync(fdPath[0]);
         }
       } catch (e) {
         if (!isEBADF(e) && !isENOENT(e)) {
@@ -31278,7 +31278,7 @@ var require_tmp = __commonJS((exports, module) => {
         }
       }
       try {
-        fs.unlinkSync(fdPath[1]);
+        fs2.unlinkSync(fdPath[1]);
       } catch (e) {
         if (!isENOENT(e)) {
           throw e;
@@ -31291,7 +31291,7 @@ var require_tmp = __commonJS((exports, module) => {
     return removeCallback;
   }
   function _prepareTmpDirRemoveCallback(name, opts) {
-    const removeFunction = opts.unsafeCleanup ? _rmdirRecursiveSync : fs.rmdirSync.bind(fs);
+    const removeFunction = opts.unsafeCleanup ? _rmdirRecursiveSync : fs2.rmdirSync.bind(fs2);
     const removeCallback = _prepareRemoveCallback(removeFunction, name);
     if (!opts.keep) {
       _removeObjects.unshift(removeCallback);
@@ -32550,13 +32550,13 @@ var require_src = __commonJS((exports, module) => {
 
 // node_modules/tabtab/lib/utils/tabtabDebug.js
 var require_tabtabDebug = __commonJS((exports, module) => {
-  var fs = __require("fs");
+  var fs2 = __require("fs");
   var util = __require("util");
   var tabtabDebug = (name) => {
     let debug = require_src()(name);
     if (process.env.TABTAB_DEBUG) {
       const file = process.env.TABTAB_DEBUG;
-      const stream = fs.createWriteStream(file, {
+      const stream = fs2.createWriteStream(file, {
         flags: "a+"
       });
       const log = (...args) => {
@@ -32700,7 +32700,7 @@ var require_promisify = __commonJS((exports) => {
 // node_modules/mkdirp/index.js
 var require_mkdirp = __commonJS((exports, module) => {
   var path = __require("path");
-  var fs = __require("fs");
+  var fs2 = __require("fs");
   var _0777 = parseInt("0777", 8);
   module.exports = mkdirP.mkdirp = mkdirP.mkdirP = mkdirP;
   function mkdirP(p, opts, f, made) {
@@ -32711,7 +32711,7 @@ var require_mkdirp = __commonJS((exports, module) => {
       opts = { mode: opts };
     }
     var mode = opts.mode;
-    var xfs = opts.fs || fs;
+    var xfs = opts.fs || fs2;
     if (mode === undefined) {
       mode = _0777;
     }
@@ -32751,7 +32751,7 @@ var require_mkdirp = __commonJS((exports, module) => {
       opts = { mode: opts };
     }
     var mode = opts.mode;
-    var xfs = opts.fs || fs;
+    var xfs = opts.fs || fs2;
     if (mode === undefined) {
       mode = _0777;
     }
@@ -32791,10 +32791,10 @@ var require_systemShell = __commonJS((exports, module) => {
 
 // node_modules/tabtab/lib/utils/exists.js
 var require_exists = __commonJS((exports, module) => {
-  var fs = __require("fs");
+  var fs2 = __require("fs");
   var untildify = require_untildify();
   var { promisify: promisify2 } = require_promisify();
-  var readFile = promisify2(fs.readFile);
+  var readFile = promisify2(fs2.readFile);
   module.exports = async (file) => {
     let fileExists;
     try {
@@ -32838,16 +32838,16 @@ var require_constants = __commonJS((exports, module) => {
 // node_modules/tabtab/lib/installer.js
 var require_installer = __commonJS((exports, module) => {
   var __dirname = "/home/runner/work/bitbucket-cli/bitbucket-cli/node_modules/tabtab/lib";
-  var fs = __require("fs");
+  var fs2 = __require("fs");
   var path = __require("path");
   var untildify = require_untildify();
   var { promisify: promisify2 } = require_promisify();
   var mkdirp = promisify2(require_mkdirp());
   var { tabtabDebug, systemShell, exists } = require_utils2();
   var debug = tabtabDebug("tabtab:installer");
-  var readFile = promisify2(fs.readFile);
-  var writeFile = promisify2(fs.writeFile);
-  var unlink = promisify2(fs.unlink);
+  var readFile = promisify2(fs2.readFile);
+  var writeFile = promisify2(fs2.writeFile);
+  var unlink = promisify2(fs2.unlink);
   var {
     BASH_LOCATION,
     FISH_LOCATION,
@@ -32907,7 +32907,7 @@ var require_installer = __commonJS((exports, module) => {
     const filepath = untildify(filename);
     debug("Creating directory for %s file", filepath);
     mkdirp(path.dirname(filepath)).then(() => {
-      const stream = fs.createWriteStream(filepath, { flags: "a" });
+      const stream = fs2.createWriteStream(filepath, { flags: "a" });
       stream.on("error", reject);
       stream.on("finish", () => resolve());
       debug("Writing to shell configuration file (%s)", filename);
@@ -33258,11 +33258,16 @@ var ServiceTokens = {
   CreatePRCommand: "CreatePRCommand",
   ListPRsCommand: "ListPRsCommand",
   ViewPRCommand: "ViewPRCommand",
+  EditPRCommand: "EditPRCommand",
   MergePRCommand: "MergePRCommand",
   ApprovePRCommand: "ApprovePRCommand",
   DeclinePRCommand: "DeclinePRCommand",
   CheckoutPRCommand: "CheckoutPRCommand",
   DiffPRCommand: "DiffPRCommand",
+  CommentPRCommand: "CommentPRCommand",
+  ListCommentsPRCommand: "ListCommentsPRCommand",
+  EditCommentPRCommand: "EditCommentPRCommand",
+  DeleteCommentPRCommand: "DeleteCommentPRCommand",
   GetConfigCommand: "GetConfigCommand",
   SetConfigCommand: "SetConfigCommand",
   ListConfigCommand: "ListConfigCommand",
@@ -34278,6 +34283,11 @@ class HttpClient {
         body: body ? JSON.stringify(body) : undefined,
         signal: controller.signal
       });
+      if (process.env.DEBUG === "true") {
+        console.debug(`[HTTP] ${method} ${url} - ${response.status}`);
+        console.debug(`[HTTP] Response Headers:`, Object.fromEntries(response.headers.entries()));
+        console.debug(`[HTTP] Response Body:`, await response.clone().text());
+      }
       clearTimeout(timeoutId);
       return acceptText ? this.handleTextResponse(response) : this.handleResponse(response);
     } catch (error) {
@@ -34298,11 +34308,12 @@ class HttpClient {
   }
   async handleResponse(response) {
     if (!response.ok) {
+      const textBody = await response.text();
       let errorBody;
       try {
-        errorBody = await response.json();
+        errorBody = JSON.parse(textBody);
       } catch {
-        errorBody = await response.text();
+        errorBody = textBody;
       }
       const message = this.extractErrorMessage(errorBody, response.statusText);
       return Result.err(new APIError(message, response.status, errorBody, {
@@ -34325,11 +34336,12 @@ class HttpClient {
   }
   async handleTextResponse(response) {
     if (!response.ok) {
+      const textBody = await response.text();
       let errorBody;
       try {
-        errorBody = await response.json();
+        errorBody = JSON.parse(textBody);
       } catch {
-        errorBody = await response.text();
+        errorBody = textBody;
       }
       const message = this.extractErrorMessage(errorBody, response.statusText);
       return Result.err(new APIError(message, response.status, errorBody, {
@@ -34391,6 +34403,16 @@ class UserRepository {
     return this.httpClient.get("/user");
   }
 }
+// src/constants.ts
+var API_PAGELEN_LIMITS = {
+  PULL_REQUESTS: 50,
+  REPOSITORIES: 100
+};
+var DEFAULT_PAGELEN = {
+  PULL_REQUESTS: 25,
+  REPOSITORIES: 25
+};
+
 // src/repositories/repo.repository.ts
 class RepoRepository {
   httpClient;
@@ -34401,7 +34423,8 @@ class RepoRepository {
     return this.httpClient.get(`/repositories/${encodeURIComponent(workspace)}/${encodeURIComponent(repoSlug)}`);
   }
   async list(workspace, limit = 25) {
-    return this.httpClient.get(`/repositories/${encodeURIComponent(workspace)}?pagelen=${limit}`);
+    const safeLimit = Math.min(limit, API_PAGELEN_LIMITS.REPOSITORIES);
+    return this.httpClient.get(`/repositories/${encodeURIComponent(workspace)}?pagelen=${safeLimit}`);
   }
   async create(workspace, request) {
     const repoSlug = request.name.toLowerCase().replace(/\s+/g, "-");
@@ -34425,19 +34448,23 @@ class PullRequestRepository {
     return this.httpClient.get(this.buildPath(workspace, repoSlug, `/${id}`));
   }
   async list(workspace, repoSlug, state = "OPEN", limit = 25) {
-    return this.httpClient.get(this.buildPath(workspace, repoSlug, `?state=${state}&pagelen=${limit}`));
+    const safeLimit = Math.min(limit, API_PAGELEN_LIMITS.PULL_REQUESTS);
+    return this.httpClient.get(this.buildPath(workspace, repoSlug, `?state=${state}&pagelen=${safeLimit}`));
   }
   async create(workspace, repoSlug, request) {
     return this.httpClient.post(this.buildPath(workspace, repoSlug), request);
   }
+  async update(workspace, repoSlug, id, request) {
+    return this.httpClient.put(this.buildPath(workspace, repoSlug, `/${id}`), request);
+  }
   async merge(workspace, repoSlug, id, request) {
     return this.httpClient.post(this.buildPath(workspace, repoSlug, `/${id}/merge`), request);
   }
   async approve(workspace, repoSlug, id) {
-    return this.httpClient.post(this.buildPath(workspace, repoSlug, `/${id}/approve`));
+    return this.httpClient.post(this.buildPath(workspace, repoSlug, `/${id}/approve`), {});
   }
   async decline(workspace, repoSlug, id) {
-    return this.httpClient.post(this.buildPath(workspace, repoSlug, `/${id}/decline`));
+    return this.httpClient.post(this.buildPath(workspace, repoSlug, `/${id}/decline`), {});
   }
   async getDiff(workspace, repoSlug, id) {
     return this.httpClient.getText(this.buildPath(workspace, repoSlug, `/${id}/diff`));
@@ -34445,6 +34472,22 @@ class PullRequestRepository {
   async getDiffstat(workspace, repoSlug, id) {
     return this.httpClient.get(this.buildPath(workspace, repoSlug, `/${id}/diffstat`));
   }
+  async listComments(workspace, repoSlug, prId, limit = 25) {
+    const safeLimit = Math.min(limit, API_PAGELEN_LIMITS.PULL_REQUESTS);
+    return this.httpClient.get(`/repositories/${encodeURIComponent(workspace)}/${encodeURIComponent(repoSlug)}/pullrequests/${prId}/comments?pagelen=${safeLimit}`);
+  }
+  async getComment(workspace, repoSlug, prId, commentId) {
+    return this.httpClient.get(`/repositories/${encodeURIComponent(workspace)}/${encodeURIComponent(repoSlug)}/pullrequests/${prId}/comments/${commentId}`);
+  }
+  async createComment(workspace, repoSlug, prId, content) {
+    return this.httpClient.post(`/repositories/${encodeURIComponent(workspace)}/${encodeURIComponent(repoSlug)}/pullrequests/${prId}/comments`, { content: { raw: content } });
+  }
+  async updateComment(workspace, repoSlug, prId, commentId, content) {
+    return this.httpClient.put(`/repositories/${encodeURIComponent(workspace)}/${encodeURIComponent(repoSlug)}/pullrequests/${prId}/comments/${commentId}`, { content: { raw: content } });
+  }
+  async deleteComment(workspace, repoSlug, prId, commentId) {
+    return this.httpClient.delete(`/repositories/${encodeURIComponent(workspace)}/${encodeURIComponent(repoSlug)}/pullrequests/${prId}/comments/${commentId}`);
+  }
 }
 // src/core/base-command.ts
 class BaseCommand {
@@ -35069,6 +35112,98 @@ class ViewPRCommand extends BaseCommand {
   }
 }
 
+// src/commands/pr/edit.command.ts
+import * as fs from "fs";
+class EditPRCommand extends BaseCommand {
+  prRepository;
+  contextService;
+  gitService;
+  name = "edit";
+  description = "Edit a pull request";
+  constructor(prRepository, contextService, gitService, output) {
+    super(output);
+    this.prRepository = prRepository;
+    this.contextService = contextService;
+    this.gitService = gitService;
+  }
+  async execute(options, context) {
+    const repoContextResult = await this.contextService.requireRepoContext({
+      ...context.globalOptions,
+      ...options
+    });
+    if (!repoContextResult.success) {
+      this.handleResult(repoContextResult, context);
+      return repoContextResult;
+    }
+    const { workspace, repoSlug } = repoContextResult.value;
+    let prId;
+    if (options.id) {
+      prId = parseInt(options.id, 10);
+    } else {
+      const branchResult = await this.gitService.getCurrentBranch();
+      if (!branchResult.success) {
+        this.handleResult(branchResult, context);
+        return branchResult;
+      }
+      const currentBranch = branchResult.value;
+      const prsResult = await this.prRepository.list(workspace, repoSlug, "OPEN", DEFAULT_PAGELEN.PULL_REQUESTS);
+      if (!prsResult.success) {
+        this.handleResult(prsResult, context);
+        return prsResult;
+      }
+      const matchingPR = prsResult.value.values.find((pr) => pr.source.branch.name === currentBranch);
+      if (!matchingPR) {
+        const error = new ValidationError("id", `No open pull request found for current branch '${currentBranch}'. Specify a PR ID explicitly.`);
+        this.output.error(error.message);
+        if (true) {
+          process.exitCode = 1;
+        }
+        return Result.err(error);
+      }
+      prId = matchingPR.id;
+    }
+    let body = options.body;
+    if (options.bodyFile) {
+      try {
+        body = fs.readFileSync(options.bodyFile, "utf-8");
+      } catch (err) {
+        const error = new ValidationError("bodyFile", `Failed to read file '${options.bodyFile}': ${err instanceof Error ? err.message : "Unknown error"}`);
+        this.output.error(error.message);
+        if (true) {
+          process.exitCode = 1;
+        }
+        return Result.err(error);
+      }
+    }
+    if (!options.title && !body) {
+      const error = new ValidationError("title", "At least one of --title or --body (or --body-file) is required.");
+      this.output.error(error.message);
+      if (true) {
+        process.exitCode = 1;
+      }
+      return Result.err(error);
+    }
+    const request = {};
+    if (options.title) {
+      request.title = options.title;
+    }
+    if (body) {
+      request.description = body;
+    }
+    const result = await this.prRepository.update(workspace, repoSlug, prId, request);
+    this.handleResult(result, context, (pr) => {
+      this.output.success(`Updated pull request #${pr.id}`);
+      this.output.text(`  ${source_default.dim("Title:")} ${pr.title}`);
+      if (pr.description) {
+        const truncatedDesc = pr.description.length > 100 ? pr.description.substring(0, 100) + "..." : pr.description;
+        this.output.text(`  ${source_default.dim("Description:")} ${truncatedDesc}`);
+      }
+      this.output.text(`  ${source_default.dim("URL:")} ${pr.links.html.href}`);
+    });
+    return result;
+  }
+}
+
 // src/commands/pr/merge.command.ts
 class MergePRCommand extends BaseCommand {
   prRepository;
@@ -35279,7 +35414,7 @@ class DiffPRCommand extends BaseCommand {
         return Result.err(error);
       }
       const currentBranch = currentBranchResult.value;
-      const prsResult = await this.prRepository.list(workspace, repoSlug, "OPEN", 100);
+      const prsResult = await this.prRepository.list(workspace, repoSlug, "OPEN", DEFAULT_PAGELEN.PULL_REQUESTS);
       if (!prsResult.success) {
         this.handleResult(prsResult, context);
         return prsResult;
@@ -35445,6 +35580,139 @@ class DiffPRCommand extends BaseCommand {
   }
 }
 
+// src/commands/pr/comment.command.ts
+class CommentPRCommand extends BaseCommand {
+  prRepository;
+  contextService;
+  name = "comment";
+  description = "Add a comment to a pull request";
+  constructor(prRepository, contextService, output) {
+    super(output);
+    this.prRepository = prRepository;
+    this.contextService = contextService;
+  }
+  async execute(options, context) {
+    const repoContextResult = await this.contextService.requireRepoContext({
+      ...context.globalOptions,
+      ...options
+    });
+    if (!repoContextResult.success) {
+      this.handleResult(repoContextResult, context);
+      return repoContextResult;
+    }
+    const { workspace, repoSlug } = repoContextResult.value;
+    const prId = parseInt(options.id, 10);
+    const result = await this.prRepository.createComment(workspace, repoSlug, prId, options.message);
+    this.handleResult(result, context, () => {
+      this.output.success(`Added comment to pull request #${prId}`);
+    });
+    return result;
+  }
+}
+
+// src/commands/pr/comments.list.command.ts
+class ListCommentsPRCommand extends BaseCommand {
+  prRepository;
+  contextService;
+  name = "comments";
+  description = "List comments on a pull request";
+  constructor(prRepository, contextService, output) {
+    super(output);
+    this.prRepository = prRepository;
+    this.contextService = contextService;
+  }
+  async execute(options, context) {
+    const repoContextResult = await this.contextService.requireRepoContext({
+      ...context.globalOptions,
+      ...options
+    });
+    if (!repoContextResult.success) {
+      this.handleResult(repoContextResult, context);
+      return repoContextResult;
+    }
+    const { workspace, repoSlug } = repoContextResult.value;
+    const prId = parseInt(options.id, 10);
+    const limit = options.limit ? parseInt(options.limit, 10) : 25;
+    const result = await this.prRepository.listComments(workspace, repoSlug, prId, limit);
+    this.handleResult(result, context, (data) => {
+      if (data.values.length === 0) {
+        this.output.info("No comments found on this pull request");
+        return;
+      }
+      const rows = data.values.map((comment) => [
+        comment.id.toString(),
+        comment.author?.username ?? comment.author?.display_name ?? "Unknown",
+        comment.content.raw.slice(0, 60) + (comment.content.raw.length > 60 ? "..." : ""),
+        this.output.formatDate(comment.created_on)
+      ]);
+      this.output.table(["ID", "Author", "Content", "Date"], rows);
+    });
+    return result;
+  }
+}
+
+// src/commands/pr/comments.edit.command.ts
+class EditCommentPRCommand extends BaseCommand {
+  prRepository;
+  contextService;
+  name = "edit";
+  description = "Edit a comment on a pull request";
+  constructor(prRepository, contextService, output) {
+    super(output);
+    this.prRepository = prRepository;
+    this.contextService = contextService;
+  }
+  async execute(options, context) {
+    const repoContextResult = await this.contextService.requireRepoContext({
+      ...context.globalOptions,
+      ...options
+    });
+    if (!repoContextResult.success) {
+      this.handleResult(repoContextResult, context);
+      return repoContextResult;
+    }
+    const { workspace, repoSlug } = repoContextResult.value;
+    const prId = parseInt(options.prId, 10);
+    const commentId = parseInt(options.commentId, 10);
+    const result = await this.prRepository.updateComment(workspace, repoSlug, prId, commentId, options.message);
+    this.handleResult(result, context, () => {
+      this.output.success(`Updated comment #${commentId}`);
+    });
+    return result;
+  }
+}
+
+// src/commands/pr/comments.delete.command.ts
+class DeleteCommentPRCommand extends BaseCommand {
+  prRepository;
+  contextService;
+  name = "delete";
+  description = "Delete a comment on a pull request";
+  constructor(prRepository, contextService, output) {
+    super(output);
+    this.prRepository = prRepository;
+    this.contextService = contextService;
+  }
+  async execute(options, context) {
+    const repoContextResult = await this.contextService.requireRepoContext({
+      ...context.globalOptions,
+      ...options
+    });
+    if (!repoContextResult.success) {
+      this.handleResult(repoContextResult, context);
+      return repoContextResult;
+    }
+    const { workspace, repoSlug } = repoContextResult.value;
+    const prId = parseInt(options.prId, 10);
+    const commentId = parseInt(options.commentId, 10);
+    const result = await this.prRepository.deleteComment(workspace, repoSlug, prId, commentId);
+    this.handleResult(result, context, () => {
+      this.output.success(`Deleted comment #${commentId} from PR #${prId}`);
+    });
+    return result;
+  }
+}
+
 // src/types/config.ts
 var SETTABLE_CONFIG_KEYS = ["defaultWorkspace"];
 var READABLE_CONFIG_KEYS = ["username", "defaultWorkspace"];
@@ -35722,6 +35990,13 @@ function bootstrap() {
     const output = container.resolve(ServiceTokens.OutputService);
     return new ViewPRCommand(prRepo, contextService, output);
   });
+  container.register(ServiceTokens.EditPRCommand, () => {
+    const prRepo = container.resolve(ServiceTokens.PullRequestRepository);
+    const contextService = container.resolve(ServiceTokens.ContextService);
+    const gitService = container.resolve(ServiceTokens.GitService);
+    const output = container.resolve(ServiceTokens.OutputService);
+    return new EditPRCommand(prRepo, contextService, gitService, output);
+  });
   container.register(ServiceTokens.MergePRCommand, () => {
     const prRepo = container.resolve(ServiceTokens.PullRequestRepository);
     const contextService = container.resolve(ServiceTokens.ContextService);
@@ -35754,6 +36029,30 @@ function bootstrap() {
     const output = container.resolve(ServiceTokens.OutputService);
     return new DiffPRCommand(prRepo, contextService, gitService, output);
   });
+  container.register(ServiceTokens.CommentPRCommand, () => {
+    const prRepo = container.resolve(ServiceTokens.PullRequestRepository);
+    const contextService = container.resolve(ServiceTokens.ContextService);
+    const output = container.resolve(ServiceTokens.OutputService);
+    return new CommentPRCommand(prRepo, contextService, output);
+  });
+  container.register(ServiceTokens.ListCommentsPRCommand, () => {
+    const prRepo = container.resolve(ServiceTokens.PullRequestRepository);
+    const contextService = container.resolve(ServiceTokens.ContextService);
+    const output = container.resolve(ServiceTokens.OutputService);
+    return new ListCommentsPRCommand(prRepo, contextService, output);
+  });
+  container.register(ServiceTokens.EditCommentPRCommand, () => {
+    const prRepo = container.resolve(ServiceTokens.PullRequestRepository);
+    const contextService = container.resolve(ServiceTokens.ContextService);
+    const output = container.resolve(ServiceTokens.OutputService);
+    return new EditCommentPRCommand(prRepo, contextService, output);
+  });
+  container.register(ServiceTokens.DeleteCommentPRCommand, () => {
+    const prRepo = container.resolve(ServiceTokens.PullRequestRepository);
+    const contextService = container.resolve(ServiceTokens.ContextService);
+    const output = container.resolve(ServiceTokens.OutputService);
+    return new DeleteCommentPRCommand(prRepo, contextService, output);
+  });
   container.register(ServiceTokens.GetConfigCommand, () => {
     const configService = container.resolve(ServiceTokens.ConfigService);
     const output = container.resolve(ServiceTokens.OutputService);
@@ -35804,7 +36103,7 @@ if (process.argv.includes("--get-yargs-completions") || process.env.COMP_LINE) {
     } else if (env2.prev === "repo") {
       completions.push("clone", "create", "list", "view", "delete");
     } else if (env2.prev === "pr") {
-      completions.push("create", "list", "view", "merge", "approve", "decline", "checkout", "diff");
+      completions.push("create", "list", "view", "edit", "merge", "approve", "decline", "checkout", "diff", "comments");
     } else if (env2.prev === "config") {
       completions.push("get", "set", "list");
     } else if (env2.prev === "completion") {
@@ -35930,6 +36229,14 @@ prCmd.command("view <id>").description("View pull request details").action(async
     process.exit(1);
   }
 });
+prCmd.command("edit [id]").description("Edit a pull request").option("-t, --title <title>", "New pull request title").option("-b, --body <body>", "New pull request description").option("-F, --body-file <file>", "Read description from file").action(async (id, options) => {
+  const cmd = container.resolve(ServiceTokens.EditPRCommand);
+  const context = createContext(cli);
+  const result = await cmd.execute(withGlobalOptions({ id, ...options }, context), context);
+  if (!result.success) {
+    process.exit(1);
+  }
+});
 prCmd.command("merge <id>").description("Merge a pull request").option("-m, --message <message>", "Merge commit message").option("--close-source-branch", "Delete the source branch after merging").option("--strategy <strategy>", "Merge strategy (merge_commit, squash, fast_forward)").action(async (id, options) => {
   const cmd = container.resolve(ServiceTokens.MergePRCommand);
   const context = createContext(cli);
@@ -35970,7 +36277,41 @@ prCmd.command("diff [id]").description("View pull request diff").option("--color
     process.exit(1);
   }
 });
+var prCommentsCmd = new Command("comments").description("Manage pull request comments");
+prCommentsCmd.command("list <id>").description("List comments on a pull request").option("--limit <number>", "Maximum number of comments (default: 25)").action(async (id, options) => {
+  const cmd = container.resolve(ServiceTokens.ListCommentsPRCommand);
+  const context = createContext(cli);
+  const result = await cmd.execute(withGlobalOptions({ id, ...options }, context), context);
+  if (!result.success) {
+    process.exit(1);
+  }
+});
+prCommentsCmd.command("add <id> <message>").description("Add a comment to a pull request").action(async (id, message, options) => {
+  const cmd = container.resolve(ServiceTokens.CommentPRCommand);
+  const context = createContext(cli);
+  const result = await cmd.execute(withGlobalOptions({ id, message }, context), context);
+  if (!result.success) {
+    process.exit(1);
+  }
+});
+prCommentsCmd.command("edit <pr-id> <comment-id> <message>").description("Edit a comment on a pull request").action(async (prId, commentId, message, options) => {
+  const cmd = container.resolve(ServiceTokens.EditCommentPRCommand);
+  const context = createContext(cli);
+  const result = await cmd.execute(withGlobalOptions({ prId, commentId, message }, context), context);
+  if (!result.success) {
+    process.exit(1);
+  }
+});
+prCommentsCmd.command("delete <pr-id> <comment-id>").description("Delete a comment on a pull request").action(async (prId, commentId, options) => {
+  const cmd = container.resolve(ServiceTokens.DeleteCommentPRCommand);
+  const context = createContext(cli);
+  const result = await cmd.execute(withGlobalOptions({ prId, commentId }, context), context);
+  if (!result.success) {
+    process.exit(1);
+  }
+});
 cli.addCommand(prCmd);
+prCmd.addCommand(prCommentsCmd);
 var configCmd = new Command("config").description("Manage configuration");
 configCmd.command("get <key>").description("Get a configuration value").action(async (key) => {
   const cmd = container.resolve(ServiceTokens.GetConfigCommand);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pilatos/bitbucket-cli",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "A command-line interface for Bitbucket Cloud",
   "author": "",
   "license": "MIT",