bitbucketdc-cli 1.0.16 → 1.0.18

package/README.md

@@ -1,6 +1,6 @@
 # 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.
+Command-line interface for [Bitbucket Data Center](https://developer.atlassian.com/server/bitbucket/rest/v819/intro/). Covers pull requests, commits, files, branches, tags, projects, repos, and comparisons.
 
 ## Install
 
@@ -26,8 +26,7 @@ All commands output JSON. Add `--pretty` to pretty-print.
 | `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 diff <project> <repo> <prId>` | Get full diff (`--format`: text/json, `--path` to filter, `--whitespace`: show/ignore-all, `--context-lines`) |
 | `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 |
@@ -48,8 +47,10 @@ All commands output JSON. Add `--pretty` to pretty-print.
 
 | 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) |
+| `bitbucketdc commit list` | List commit history on a ref, optionally scoped by path or range |
+| `bitbucketdc commit get` | Get metadata for a single commit |
+| `bitbucketdc commit changes` | List changed files in a commit (`--commit <ref>`) |
+| `bitbucketdc commit diff` | Get diff for a commit (`--commit <ref>`, `--path` to filter) |
 
 ### compare
 
@@ -65,6 +66,18 @@ All commands output JSON. Add `--pretty` to pretty-print.
 | `bitbucketdc file list <project> <repo>` | List files and directories (`--path`, `--at` ref) |
 | `bitbucketdc file show <project> <repo> <path>` | Show file content (`--at` ref) |
 
+### branch
+
+| Command | Description |
+|---------|-------------|
+| `bitbucketdc branch list` | List branches with optional filters (`--filter`, `--order-by`, `--details`, `--base`) |
+
+### tag
+
+| Command | Description |
+|---------|-------------|
+| `bitbucketdc tag list` | List tags with optional filters (`--filter`, `--order-by`) |
+
 ### project
 
 | Command | Description |
@@ -76,6 +89,8 @@ All commands output JSON. Add `--pretty` to pretty-print.
 | Command | Description |
 |---------|-------------|
 | `bitbucketdc repo list` | List repositories (`--project`, `--name` filter) |
+| `bitbucketdc repo get` | Get full repository metadata (includes defaultBranch, project, links) |
+| `bitbucketdc repo default-branch` | Read the default branch configured for a repository |
 | `bitbucketdc repo clone <project> <repo>` | Clone a repository |
 | `bitbucketdc repo attachment download <project> <repo> <path>` | Download a repo attachment |
 
@@ -95,8 +110,8 @@ 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
+# Diff a single file within a PR
+bitbucketdc pr diff AI my-repo 42 --path src/index.ts --format json
 
 # Approve a PR
 bitbucketdc pr review AI my-repo 42 APPROVED
@@ -118,4 +133,21 @@ 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"
+
+# Inspect repo metadata and default branch
+bitbucketdc repo get --project AI --repo delivery
+bitbucketdc repo default-branch --project AI --repo delivery
+
+# List release branches
+bitbucketdc branch list --project AI --repo delivery --filter operator-release/
+
+# Walk recent commit history
+bitbucketdc commit list --project AI --repo delivery --until main --limit 10
 ```
+
+## Breaking changes in this release
+
+- `repo list --project-key` renamed to `--project` (matches the flag naming used across every other command).
+- `file list` / `file show` — the `--branch` alias has been removed. Use `--at <ref>` instead.
+- `pr file-diff` has been removed. Use `pr diff --path <path> --format json` to get the JSON diff for a single file within a PR.
+- `commit get` now takes `--commit <ref>` (consistent with `commit changes` and `commit diff`) instead of a positional argument.

package/dist/index.js

@@ -5,7 +5,10 @@ import { readFileSync } from "fs";
 import { dirname, join } from "path";
 import { fileURLToPath } from "url";
 import { styleText } from "util";
-import { Command as Command9 } from "commander";
+import { Command as Command12 } from "commander";
+
+// src/commands/branch/list.ts
+import { Option } from "commander";
 
 // src/utils/cli.ts
 import { InvalidArgumentError } from "commander";
@@ -177,6 +180,42 @@ function handleError(err) {
   process.exit(1);
 }
 
+// src/commands/branch/list.ts
+var ORDER_BY_MODES = ["ALPHABETICAL", "MODIFICATION"];
+function list(parent) {
+  parent.command("list").description("List branches in a repository with optional filters").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").option("--filter <text>", "Prefix-match on branch name").addOption(new Option("--order-by <mode>", "Sort order").choices(ORDER_BY_MODES)).option("--details", "Include branch metadata (ahead/behind, latest commit)").option("--base <ref>", "Compare metadata against this ref").option("--boost-matches", "Rank exact matches above prefix matches").option("--start <n>", "Starting index for pagination", nonNegativeInt).option("--limit <n>", "Maximum results to return (1-1000)", intInRange(1, 1e3), 25).addHelpText(
+    "after",
+    `
+Examples:
+  bitbucketdc branch list --project AI --repo delivery
+  bitbucketdc branch list --project AI --repo delivery --filter operator-release/
+  bitbucketdc branch list --project AI --repo delivery --order-by MODIFICATION --limit 10
+  bitbucketdc branch list --project AI --repo delivery --details`
+  ).action(
+    async (opts) => {
+      const client = getClient();
+      const result = await client.branches.list({
+        projectKey: opts.project,
+        repositorySlug: opts.repo,
+        filterText: opts.filter,
+        orderBy: opts.orderBy,
+        details: opts.details,
+        base: opts.base,
+        boostMatches: opts.boostMatches,
+        start: opts.start,
+        limit: opts.limit
+      });
+      output(result);
+    }
+  );
+}
+
+// src/commands/branch/index.ts
+function registerBranchCommands(program2) {
+  const branch = program2.command("branch").description("Branch operations");
+  list(branch);
+}
+
 // src/commands/commit/changes.ts
 function changes(parent) {
   parent.command("changes").description("List files changed in a specific commit").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--commit <hash>", "Commit hash").option("--limit <n>", "Number of items to return (1-1000)", intInRange(1, 1e3), 25).option("--start <n>", "Start index for pagination", nonNegativeInt).addHelpText(
@@ -187,7 +226,7 @@ Examples:
   bitbucketdc commit changes --project AI --repo my-app --commit abc123 --limit 100`
   ).action(async (opts) => {
     const client = getClient();
-    const result = await client.repositories.getCommitChanges({
+    const result = await client.commits.getChanges({
       projectKey: opts.project,
       repositorySlug: opts.repo,
       commitId: opts.commit,
@@ -199,11 +238,11 @@ Examples:
 }
 
 // src/commands/commit/diff.ts
-import { Option } from "commander";
+import { Option as Option2 } from "commander";
 var WHITESPACE_MODES = ["show", "ignore-all"];
 var DIFF_FORMATS = ["text", "json"];
 function diff(parent) {
-  parent.command("diff").description("Get diff for a specific commit").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--commit <hash>", "Commit hash").option("--path <path>", "Scope diff to a single file").option("--context <n>", "Number of context lines around changes (0-500)", intInRange(0, 500)).addOption(new Option("--whitespace <mode>", "Whitespace handling").choices(WHITESPACE_MODES)).addOption(new Option("--format <fmt>", "Response format").choices(DIFF_FORMATS).default("text")).addHelpText(
+  parent.command("diff").description("Get diff for a specific commit").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--commit <hash>", "Commit hash").option("--path <path>", "Scope diff to a single file").option("--context <n>", "Number of context lines around changes (0-500)", intInRange(0, 500)).addOption(new Option2("--whitespace <mode>", "Whitespace handling").choices(WHITESPACE_MODES)).addOption(new Option2("--format <fmt>", "Response format").choices(DIFF_FORMATS).default("text")).addHelpText(
     "after",
     `
 Examples:
@@ -213,7 +252,7 @@ Examples:
   ).action(
     async (opts) => {
       const client = getClient();
-      const result = await client.repositories.getCommitDiff({
+      const result = await client.commits.getDiff({
         projectKey: opts.project,
         repositorySlug: opts.repo,
         commitId: opts.commit,
@@ -231,17 +270,75 @@ Examples:
   );
 }
 
+// src/commands/commit/get.ts
+function get(parent) {
+  parent.command("get").description("Get metadata for a single commit").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--commit <ref>", "Commit hash or any ref (branch, tag)").option("--path <p>", "Filter to changes touching this path").addHelpText(
+    "after",
+    `
+Examples:
+  bitbucketdc commit get --project AI --repo delivery --commit 8165d8f
+  bitbucketdc commit get --project AI --repo delivery --commit main
+  bitbucketdc commit get --project AI --repo delivery --commit main --path src/index.ts`
+  ).action(async (opts) => {
+    const client = getClient();
+    const result = await client.commits.get({
+      projectKey: opts.project,
+      repositorySlug: opts.repo,
+      commitId: opts.commit,
+      path: opts.path
+    });
+    output(result);
+  });
+}
+
+// src/commands/commit/list.ts
+import { Option as Option3 } from "commander";
+var MERGES_MODES = ["include", "exclude", "only"];
+function list2(parent) {
+  parent.command("list").description("List commit history on a ref, optionally scoped by path or range").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").option("--path <p>", "Restrict to commits touching this path").option("--since <ref>", "Range start (commit ID or ref), exclusive").option("--until <ref>", "Range end (commit ID or ref). Alone, lists commits reachable from this ref.").addOption(new Option3("--merges <mode>", "Merge commit handling").choices(MERGES_MODES)).option("--follow-renames", "Track file renames (only meaningful with --path)").option("--ignore-missing", "Tolerate missing --since/--until refs instead of 404").option("--with-counts", "Include commit/author totals in response").option("--start <n>", "Starting index for pagination", nonNegativeInt).option("--limit <n>", "Maximum results to return (1-1000)", intInRange(1, 1e3), 25).addHelpText(
+    "after",
+    `
+Examples:
+  bitbucketdc commit list --project AI --repo delivery
+  bitbucketdc commit list --project AI --repo delivery --until main --limit 10
+  bitbucketdc commit list --project AI --repo delivery --since operator-release/5.1.6 --until operator-release/5.1.7
+  bitbucketdc commit list --project AI --repo delivery --path package.json --follow-renames`
+  ).action(
+    async (opts) => {
+      const client = getClient();
+      const result = await client.commits.list({
+        projectKey: opts.project,
+        repositorySlug: opts.repo,
+        path: opts.path,
+        since: opts.since,
+        until: opts.until,
+        merges: opts.merges,
+        followRenames: opts.followRenames,
+        ignoreMissing: opts.ignoreMissing,
+        withCounts: opts.withCounts,
+        start: opts.start,
+        limit: opts.limit
+      });
+      output(result);
+    }
+  );
+}
+
 // src/commands/commit/index.ts
 function registerCommitCommands(program2) {
   const commit = program2.command("commit").description("Commit inspection operations").addHelpText(
     "after",
     `
 Examples:
+  $ bitbucketdc commit list --project AI --repo my-app --limit 10
+  $ bitbucketdc commit get --project AI --repo my-app --commit abc123
   $ bitbucketdc commit changes --project AI --repo my-app --commit abc123
   $ bitbucketdc commit diff --project AI --repo my-app --commit abc123
   $ bitbucketdc commit diff --project AI --repo my-app --commit abc123 --path src/main.ts
 `
   );
+  list2(commit);
+  get(commit);
   changes(commit);
   diff(commit);
 }
@@ -258,7 +355,7 @@ Examples:
   ).action(
     async (opts) => {
       const client = getClient();
-      const result = await client.repositories.getCompareChanges({
+      const result = await client.compare.getChanges({
         projectKey: opts.project,
         repositorySlug: opts.repo,
         from: opts.from,
@@ -272,10 +369,10 @@ Examples:
 }
 
 // src/commands/compare/diff.ts
-import { Option as Option2 } from "commander";
+import { Option as Option4 } from "commander";
 var WHITESPACE_MODES2 = ["show", "ignore-all"];
 function diff2(parent) {
-  parent.command("diff").description("Get diff between two refs (structured JSON)").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--from <ref>", "Source ref (branch, tag, or commit)").requiredOption("--to <ref>", "Target ref (branch, tag, or commit)").option("--path <path>", "Scope diff to a single file").option("--context <n>", "Number of context lines around changes (0-500)", intInRange(0, 500)).addOption(new Option2("--whitespace <mode>", "Whitespace handling").choices(WHITESPACE_MODES2)).addHelpText(
+  parent.command("diff").description("Get diff between two refs (structured JSON)").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--from <ref>", "Source ref (branch, tag, or commit)").requiredOption("--to <ref>", "Target ref (branch, tag, or commit)").option("--path <path>", "Scope diff to a single file").option("--context <n>", "Number of context lines around changes (0-500)", intInRange(0, 500)).addOption(new Option4("--whitespace <mode>", "Whitespace handling").choices(WHITESPACE_MODES2)).addHelpText(
     "after",
     `
 Examples:
@@ -284,7 +381,7 @@ Examples:
   ).action(
     async (opts) => {
       const client = getClient();
-      const result = await client.repositories.getCompareDiff({
+      const result = await client.compare.getDiff({
         projectKey: opts.project,
         repositorySlug: opts.repo,
         from: opts.from,
@@ -314,8 +411,8 @@ Examples:
 }
 
 // src/commands/file/list.ts
-function list(parent) {
-  parent.command("list").description("List directory contents in a repository").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").option("--path <path>", "Directory path (defaults to root)").option("--at <ref>", "Branch, tag, or commit hash").option("--branch <ref>", "Alias for --at").option("--limit <n>", "Number of items to return (1-1000)", intInRange(1, 1e3), 25).option("--start <n>", "Start index for pagination", nonNegativeInt).addHelpText(
+function list3(parent) {
+  parent.command("list").description("List directory contents in a repository").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").option("--path <path>", "Directory path (defaults to root)").option("--at <ref>", "Branch, tag, or commit hash").option("--limit <n>", "Number of items to return (1-1000)", intInRange(1, 1e3), 25).option("--start <n>", "Start index for pagination", nonNegativeInt).addHelpText(
     "after",
     `
 Examples:
@@ -325,12 +422,11 @@ Examples:
   ).action(
     async (opts) => {
       const client = getClient();
-      const ref = opts.at ?? opts.branch;
-      const result = await client.repositories.browse({
+      const result = await client.files.browse({
         projectKey: opts.project,
         repositorySlug: opts.repo,
         path: opts.path,
-        at: ref,
+        at: opts.at,
         limit: opts.limit,
         start: opts.start
       });
@@ -341,7 +437,7 @@ Examples:
 
 // src/commands/file/show.ts
 function show(parent) {
-  parent.command("show").description("Show raw file content from a repository").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--path <path>", "File path").option("--at <ref>", "Branch, tag, or commit hash").option("--branch <ref>", "Alias for --at").addHelpText(
+  parent.command("show").description("Show raw file content from a repository").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--path <path>", "File path").option("--at <ref>", "Branch, tag, or commit hash").addHelpText(
     "after",
     `
 Examples:
@@ -349,12 +445,11 @@ Examples:
   bitbucketdc file show --project PROJ --repo my-app --path config/settings.yaml --at release/2.0`
   ).action(async (opts) => {
     const client = getClient();
-    const ref = opts.at ?? opts.branch;
-    const result = await client.repositories.getRawContent({
+    const result = await client.files.getRawContent({
       projectKey: opts.project,
       repositorySlug: opts.repo,
       path: opts.path,
-      at: ref
+      at: opts.at
     });
     process.stdout.write(result);
   });
@@ -371,7 +466,7 @@ Examples:
   $ bitbucketdc file show --project PROJ --repo my-app --path README.md
 `
   );
-  list(file);
+  list3(file);
   show(file);
 }
 
@@ -552,11 +647,11 @@ function deletePr(parent) {
 }
 
 // src/commands/pr/diff.ts
-import { Option as Option3 } from "commander";
+import { Option as Option5 } from "commander";
 var WHITESPACE_MODES3 = ["show", "ignore-all"];
 var DIFF_FORMATS2 = ["text", "json"];
 function diff3(parent) {
-  parent.command("diff").description("Get diff for a pull request").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID", positiveInt).option("--path <path>", "File path (omit for full PR diff)").option("--since <hash>", "Since commit hash").option("--until <hash>", "Until commit hash").option("--context <n>", "Number of context lines around changes (0-500)", intInRange(0, 500), 10).addOption(new Option3("--whitespace <mode>", "Whitespace handling").choices(WHITESPACE_MODES3).default("show")).addOption(new Option3("--format <fmt>", "Response format").choices(DIFF_FORMATS2).default("text")).addHelpText(
+  parent.command("diff").description("Get diff for a pull request").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID", positiveInt).option("--path <path>", "File path (omit for full PR diff)").option("--since <hash>", "Since commit hash").option("--until <hash>", "Until commit hash").option("--context <n>", "Number of context lines around changes (0-500)", intInRange(0, 500), 10).addOption(new Option5("--whitespace <mode>", "Whitespace handling").choices(WHITESPACE_MODES3).default("show")).addOption(new Option5("--format <fmt>", "Response format").choices(DIFF_FORMATS2).default("text")).addHelpText(
     "after",
     `
 Examples:
@@ -630,26 +725,8 @@ function fileComment(parent) {
   });
 }
 
-// src/commands/pr/file-diff.ts
-function fileDiff(parent) {
-  parent.command("file-diff").description("Get structured line-by-line diff for a specific file").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID", positiveInt).requiredOption("--path <path>", "File path (e.g., src/main.ts)").option("--context <n>", "Number of context lines around changes (0-500)", intInRange(0, 500), 10).addHelpText(
-    "after",
-    "\nExamples:\n  bitbucketdc pr file-diff --project PROJ --repo my-repo --id 42 --path src/main.ts\n  bitbucketdc pr file-diff --project PROJ --repo my-repo --id 42 --path src/main.ts --context 5"
-  ).action(async (opts) => {
-    const client = getClient();
-    const result = await client.pullRequests.getFileDiff({
-      projectKey: opts.project,
-      repositorySlug: opts.repo,
-      pullRequestId: opts.id,
-      path: opts.path,
-      contextLines: opts.context
-    });
-    output(result);
-  });
-}
-
 // src/commands/pr/get.ts
-function get(parent) {
+function get2(parent) {
   parent.command("get").description("Get pull request details").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID", positiveInt).addHelpText("after", "\nExamples:\n  bitbucketdc pr get --project PROJ --repo my-repo --id 42").action(async (opts) => {
     const client = getClient();
     const result = await client.pullRequests.get({
@@ -677,12 +754,12 @@ function inbox(parent) {
 }
 
 // src/commands/pr/line-comment.ts
-import { Option as Option4 } from "commander";
+import { Option as Option6 } from "commander";
 var LINE_TYPES = ["ADDED", "REMOVED", "CONTEXT"];
 var FILE_TYPES = ["FROM", "TO"];
 function lineComment(parent) {
-  parent.command("line-comment").description("Add an inline comment to a specific line in a pull request").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID", positiveInt).requiredOption("--text <text>", "Comment text").requiredOption("--path <path>", "File path (e.g., src/main.ts)").requiredOption("--line <n>", "Line number to comment on", positiveInt).addOption(new Option4("--line-type <type>", "Type of line").choices(LINE_TYPES).makeOptionMandatory()).addOption(
-    new Option4("--file-type <type>", "Side of diff: FROM (source/old) or TO (destination/new)").choices(FILE_TYPES).makeOptionMandatory()
+  parent.command("line-comment").description("Add an inline comment to a specific line in a pull request").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID", positiveInt).requiredOption("--text <text>", "Comment text").requiredOption("--path <path>", "File path (e.g., src/main.ts)").requiredOption("--line <n>", "Line number to comment on", positiveInt).addOption(new Option6("--line-type <type>", "Type of line").choices(LINE_TYPES).makeOptionMandatory()).addOption(
+    new Option6("--file-type <type>", "Side of diff: FROM (source/old) or TO (destination/new)").choices(FILE_TYPES).makeOptionMandatory()
   ).addHelpText(
     "after",
     `
@@ -730,10 +807,10 @@ Examples:
 }
 
 // src/commands/pr/reaction-add.ts
-import { Option as Option5 } from "commander";
+import { Option as Option7 } from "commander";
 function reactionAdd(parent) {
   parent.command("reaction-add").description("Add an emoticon reaction to a PR comment").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID", positiveInt).requiredOption("--comment-id <n>", "Comment ID", positiveInt).addOption(
-    new Option5("--emoticon <name>", "Emoticon to react with").choices(["thumbsup", "thumbsdown", "heart", "thinking_face", "laughing"]).makeOptionMandatory()
+    new Option7("--emoticon <name>", "Emoticon to react with").choices(["thumbsup", "thumbsdown", "heart", "thinking_face", "laughing"]).makeOptionMandatory()
   ).addHelpText(
     "after",
     `
@@ -756,10 +833,10 @@ Examples:
 }
 
 // src/commands/pr/reaction-remove.ts
-import { Option as Option6 } from "commander";
+import { Option as Option8 } from "commander";
 function reactionRemove(parent) {
   parent.command("reaction-remove").description("Remove an emoticon reaction from a PR comment").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID", positiveInt).requiredOption("--comment-id <n>", "Comment ID", positiveInt).addOption(
-    new Option6("--emoticon <name>", "Emoticon to remove").choices(["thumbsup", "thumbsdown", "heart", "thinking_face", "laughing"]).makeOptionMandatory()
+    new Option8("--emoticon <name>", "Emoticon to remove").choices(["thumbsup", "thumbsdown", "heart", "thinking_face", "laughing"]).makeOptionMandatory()
   ).addHelpText(
     "after",
     `
@@ -781,10 +858,10 @@ Examples:
 }
 
 // src/commands/pr/review.ts
-import { Option as Option7 } from "commander";
+import { Option as Option9 } from "commander";
 var REVIEW_STATUSES = ["APPROVED", "NEEDS_WORK", "UNAPPROVED"];
 function review(parent) {
-  parent.command("review").description("Update review status for a pull request").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID", positiveInt).addOption(new Option7("--status <status>", "Review status").choices(REVIEW_STATUSES).makeOptionMandatory()).addHelpText(
+  parent.command("review").description("Update review status for a pull request").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").requiredOption("--id <n>", "Pull request ID", positiveInt).addOption(new Option9("--status <status>", "Review status").choices(REVIEW_STATUSES).makeOptionMandatory()).addHelpText(
     "after",
     `
 Examples:
@@ -814,9 +891,7 @@ Examples:
   bitbucketdc pr update --project PROJ --repo my-repo --id 42 --title "New" --description "Both"`
   ).action(async (opts) => {
     if (!opts.title && !opts.description) {
-      process.stderr.write(`${JSON.stringify({ error: "At least one of --title or --description is required" })}
-`);
-      process.exit(1);
+      throw new Error("At least one of --title or --description is required");
     }
     const client = getClient();
     const result = await client.pullRequests.update({
@@ -851,10 +926,9 @@ Examples:
 `
   );
   inbox(pr);
-  get(pr);
+  get2(pr);
   changes3(pr);
   diff3(pr);
-  fileDiff(pr);
   activities(pr);
   create(pr);
   comment(pr);
@@ -873,7 +947,7 @@ Examples:
 }
 
 // src/commands/project/list.ts
-function list2(parent) {
+function list4(parent) {
   parent.command("list").description("List projects").option("--name <name>", "Filter projects by name (partial match)").option("--permission <permission>", "Filter by permission (e.g., PROJECT_READ, PROJECT_WRITE, PROJECT_ADMIN)").option("--start <start>", "Starting index for pagination", nonNegativeInt).option("--limit <limit>", "Maximum number of projects to return (1-1000)", intInRange(1, 1e3), 25).addHelpText(
     "after",
     '\nExamples:\n  bitbucketdc project list\n  bitbucketdc project list --name "My Project"\n  bitbucketdc project list --permission PROJECT_READ --limit 10'
@@ -899,7 +973,7 @@ Examples:
   $ bitbucketdc project list --name "My Project" --limit 10
 `
   );
-  list2(project);
+  list4(project);
 }
 
 // src/commands/repo/attachment/download.ts
@@ -981,11 +1055,7 @@ Examples:
     const token = process.env.BITBUCKET_TOKEN;
     if (!baseUrl || !token) {
       const missing = [...!baseUrl ? ["BITBUCKET_URL"] : [], ...!token ? ["BITBUCKET_TOKEN"] : []];
-      process.stderr.write(
-        `${JSON.stringify({ error: `Missing required environment variables: ${missing.join(", ")}` })}
-`
-      );
-      process.exit(1);
+      throw new Error(`Missing required environment variables: ${missing.join(", ")}`);
     }
     const cloneUrl = `${baseUrl}/scm/${opts.project}/${opts.repo}.git`;
     const args = ["-c", `http.extraHeader=Authorization: Bearer ${token}`, "clone", cloneUrl];
@@ -994,25 +1064,62 @@ Examples:
   });
 }
 
+// src/commands/repo/default-branch.ts
+function defaultBranch(parent) {
+  parent.command("default-branch").description("Read the default branch configured for a repository (read-only)").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").addHelpText(
+    "after",
+    `
+Examples:
+  bitbucketdc repo default-branch --project AI --repo delivery
+
+Note: this command is read-only. Setting a default branch is not exposed by this CLI.`
+  ).action(async (opts) => {
+    const client = getClient();
+    const result = await client.repositories.getDefaultBranch({
+      projectKey: opts.project,
+      repositorySlug: opts.repo
+    });
+    output(result);
+  });
+}
+
+// src/commands/repo/get.ts
+function get3(parent) {
+  parent.command("get").description("Get full metadata for a repository (includes defaultBranch, project, links)").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").addHelpText(
+    "after",
+    `
+Examples:
+  bitbucketdc repo get --project AI --repo delivery
+  bitbucketdc repo get --project AI --repo gregosystem-v2`
+  ).action(async (opts) => {
+    const client = getClient();
+    const result = await client.repositories.get({
+      projectKey: opts.project,
+      repositorySlug: opts.repo
+    });
+    output(result);
+  });
+}
+
 // src/commands/repo/list.ts
-import { Option as Option8 } from "commander";
+import { Option as Option10 } from "commander";
 var VISIBILITIES = ["public", "private"];
 var ARCHIVE_STATES = ["ACTIVE", "ARCHIVED", "ALL"];
-function list3(parent) {
-  parent.command("list").description("List repositories with optional filters").option("--name <name>", "Filter by repository name (case-insensitive)").option("--project-key <key>", "Filter by project key").option("--project-name <name>", "Filter by project name (case-insensitive)").addOption(new Option8("--visibility <type>", "Filter by visibility").choices(VISIBILITIES)).addOption(new Option8("--archived <status>", "Filter by archived status").choices(ARCHIVE_STATES)).option("--start <n>", "Starting index for pagination", nonNegativeInt).option("--limit <n>", "Maximum results to return (1-1000)", intInRange(1, 1e3), 25).addHelpText(
+function list5(parent) {
+  parent.command("list").description("List repositories with optional filters").option("--name <name>", "Filter by repository name (case-insensitive)").option("--project <key>", "Filter by project key").option("--project-name <name>", "Filter by project name (case-insensitive)").addOption(new Option10("--visibility <type>", "Filter by visibility").choices(VISIBILITIES)).addOption(new Option10("--archived <status>", "Filter by archived status").choices(ARCHIVE_STATES)).option("--start <n>", "Starting index for pagination", nonNegativeInt).option("--limit <n>", "Maximum results to return (1-1000)", intInRange(1, 1e3), 25).addHelpText(
     "after",
     `
 Examples:
   bitbucketdc repo list
   bitbucketdc repo list --name my-repo
-  bitbucketdc repo list --project-key AI
-  bitbucketdc repo list --project-key AI --name svc --limit 50`
+  bitbucketdc repo list --project AI
+  bitbucketdc repo list --project AI --name svc --limit 50`
   ).action(
     async (opts) => {
       const client = getClient();
       const result = await client.repositories.list({
         name: opts.name,
-        projectkey: opts.projectKey,
+        projectkey: opts.project,
         projectname: opts.projectName,
         visibility: opts.visibility,
         archived: opts.archived,
@@ -1031,18 +1138,53 @@ function registerRepoCommands(program2) {
     `
 Examples:
   $ bitbucketdc repo list
-  $ bitbucketdc repo list --name my-repo --project-key AI
+  $ bitbucketdc repo list --name my-repo --project AI
   $ bitbucketdc repo clone --project AI --repo my-repo
   $ bitbucketdc repo attachment download --project PROJ --repo my-repo --id abc123 --output ./file.png
 `
   );
-  list3(repo);
+  list5(repo);
+  get3(repo);
+  defaultBranch(repo);
   clone(repo);
   registerAttachmentCommands(repo);
 }
 
+// src/commands/tag/list.ts
+import { Option as Option11 } from "commander";
+var ORDER_BY_MODES2 = ["ALPHABETICAL", "MODIFICATION"];
+function list6(parent) {
+  parent.command("list").description("List tags in a repository with optional filters").requiredOption("--project <key>", "Bitbucket project key").requiredOption("--repo <slug>", "Repository slug").option("--filter <text>", "Prefix-match on tag name").addOption(new Option11("--order-by <mode>", "Sort order").choices(ORDER_BY_MODES2)).option("--start <n>", "Starting index for pagination", nonNegativeInt).option("--limit <n>", "Maximum results to return (1-1000)", intInRange(1, 1e3), 25).addHelpText(
+    "after",
+    `
+Examples:
+  bitbucketdc tag list --project AI --repo delivery
+  bitbucketdc tag list --project AI --repo delivery --filter v --limit 10
+  bitbucketdc tag list --project AI --repo delivery --order-by MODIFICATION`
+  ).action(
+    async (opts) => {
+      const client = getClient();
+      const result = await client.tags.list({
+        projectKey: opts.project,
+        repositorySlug: opts.repo,
+        filterText: opts.filter,
+        orderBy: opts.orderBy,
+        start: opts.start,
+        limit: opts.limit
+      });
+      output(result);
+    }
+  );
+}
+
+// src/commands/tag/index.ts
+function registerTagCommands(program2) {
+  const tag = program2.command("tag").description("Tag operations");
+  list6(tag);
+}
+
 // src/commands/user/list.ts
-function list4(parent) {
+function list7(parent) {
   parent.command("list").description("List all users").option("--filter <filter>", "Filter users by username, name or email (partial match)").addHelpText("after", "\nExamples:\n  bitbucketdc user list\n  bitbucketdc user list --filter john").action(async (opts) => {
     const client = getClient();
     const result = await client.users.getAll(opts.filter ? { filter: opts.filter } : void 0);
@@ -1070,7 +1212,7 @@ Examples:
 `
   );
   profile(user);
-  list4(user);
+  list7(user);
 }
 
 // src/index.ts
@@ -1086,7 +1228,7 @@ function readPackageVersion() {
 }
 var DIM = "\x1B[2m";
 var RESET = "\x1B[0m";
-var program = new Command9();
+var program = new Command12();
 program.name("bitbucketdc").description("Bitbucket Data Center CLI").version(readPackageVersion()).configureHelp({
   styleTitle: (str) => styleText("bold", str),
   styleUsage: (str) => styleText("dim", str),
@@ -1118,6 +1260,8 @@ program.hook("preAction", (thisCommand) => {
 registerUserCommands(program);
 registerProjectCommands(program);
 registerRepoCommands(program);
+registerBranchCommands(program);
+registerTagCommands(program);
 registerFileCommands(program);
 registerCommitCommands(program);
 registerCompareCommands(program);

package/package.json

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