bitbucketdc-cli 1.0.14 → 1.0.16

package/README.md

@@ -0,0 +1,121 @@
+# bitbucketdc-cli
+
+Command-line interface for [Bitbucket Data Center](https://developer.atlassian.com/server/bitbucket/rest/v819/intro/). 33 commands across 6 domains — pull requests, commits, files, projects, repos, and comparisons.
+
+## Install
+
+```bash
+npm install -g bitbucketdc-cli
+```
+
+## Setup
+
+```bash
+export BITBUCKET_URL="https://bitbucket.example.com"   # Base URL of your Bitbucket instance
+export BITBUCKET_TOKEN="your-personal-access-token"     # HTTP Access Token from Bitbucket
+```
+
+## Commands
+
+All commands output JSON. Add `--pretty` to pretty-print.
+
+### pr
+
+| Command | Description |
+|---------|-------------|
+| `bitbucketdc pr inbox` | List pull requests in your reviewer inbox |
+| `bitbucketdc pr get <project> <repo> <prId>` | Get pull request details |
+| `bitbucketdc pr changes <project> <repo> <prId>` | List changed files |
+| `bitbucketdc pr diff <project> <repo> <prId>` | Get full diff (`--format`: text/json, `--whitespace`: show/ignore-all, `--context-lines`) |
+| `bitbucketdc pr file-diff <project> <repo> <prId> <path>` | Get diff for a specific file |
+| `bitbucketdc pr activities <project> <repo> <prId>` | List activities/events on a PR |
+| `bitbucketdc pr create <project> <repo>` | Create a PR (auto-fetches default reviewers) |
+| `bitbucketdc pr comment <project> <repo> <prId>` | Add a general comment |
+| `bitbucketdc pr file-comment <project> <repo> <prId>` | Add a comment on a specific file |
+| `bitbucketdc pr line-comment <project> <repo> <prId>` | Add an inline comment on a specific line |
+| `bitbucketdc pr delete-comment <project> <repo> <prId> <commentId>` | Delete a comment |
+| `bitbucketdc pr edit-comment <project> <repo> <prId> <commentId>` | Edit a comment |
+| `bitbucketdc pr reaction-add <project> <repo> <prId> <commentId>` | Add emoji reaction to a comment |
+| `bitbucketdc pr reaction-remove <project> <repo> <prId> <commentId>` | Remove emoji reaction from a comment |
+| `bitbucketdc pr review <project> <repo> <prId> <status>` | Set review status (APPROVED, NEEDS_WORK, UNAPPROVED) |
+| `bitbucketdc pr update <project> <repo> <prId>` | Update PR title/description |
+| `bitbucketdc pr can-merge <project> <repo> <prId>` | Check merge eligibility |
+| `bitbucketdc pr merge <project> <repo> <prId>` | Merge a PR (`--strategy`: merge-commit, squash, ff-only) |
+| `bitbucketdc pr decline <project> <repo> <prId>` | Decline/close a PR |
+| `bitbucketdc pr delete <project> <repo> <prId>` | Delete a PR |
+
+### commit
+
+| Command | Description |
+|---------|-------------|
+| `bitbucketdc commit changes <project> <repo> <commitId>` | List changed files in a commit |
+| `bitbucketdc commit diff <project> <repo> <commitId>` | Get diff for a commit (`--path` to filter) |
+
+### compare
+
+| Command | Description |
+|---------|-------------|
+| `bitbucketdc compare changes <project> <repo>` | List changed files between refs (`--from`, `--to`) |
+| `bitbucketdc compare diff <project> <repo>` | Get diff between refs |
+
+### file
+
+| Command | Description |
+|---------|-------------|
+| `bitbucketdc file list <project> <repo>` | List files and directories (`--path`, `--at` ref) |
+| `bitbucketdc file show <project> <repo> <path>` | Show file content (`--at` ref) |
+
+### project
+
+| Command | Description |
+|---------|-------------|
+| `bitbucketdc project list` | List Bitbucket projects |
+
+### repo
+
+| Command | Description |
+|---------|-------------|
+| `bitbucketdc repo list` | List repositories (`--project`, `--name` filter) |
+| `bitbucketdc repo clone <project> <repo>` | Clone a repository |
+| `bitbucketdc repo attachment download <project> <repo> <path>` | Download a repo attachment |
+
+## Pagination
+
+List commands accept `--limit` to control page size. Responses include `nextPage` — pass it back as `--start` to fetch the next page. When `nextPage` is `null`, there are no more results.
+
+## Examples
+
+```bash
+# Check your PR inbox
+bitbucketdc pr inbox
+
+# Get a PR with full details
+bitbucketdc pr get AI my-repo 42
+
+# Review the diff
+bitbucketdc pr diff AI my-repo 42 --context-lines 5
+
+# Diff a single file
+bitbucketdc pr file-diff AI my-repo 42 src/index.ts
+
+# Approve a PR
+bitbucketdc pr review AI my-repo 42 APPROVED
+
+# Leave an inline comment on a specific line
+bitbucketdc pr line-comment AI my-repo 42 --path src/index.ts --line 15 --line-type ADDED --text "Nitpick: rename this variable"
+
+# Create a PR (auto-adds default reviewers)
+bitbucketdc pr create AI my-repo --from feature/x --to main --title "Add feature X"
+
+# Merge with squash
+bitbucketdc pr merge AI my-repo 42 --strategy squash
+
+# Browse files at a specific branch
+bitbucketdc file list AI my-repo --path src/ --at develop
+
+# Show file content
+bitbucketdc file show AI my-repo src/config.ts --at main
+
+# Search repos by name within a project
+bitbucketdc repo list --project AI --name "tool"
+```

package/package.json

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