@pilatos/bitbucket-cli 1.8.3 → 1.9.0

package/dist/index.js

@@ -14337,6 +14337,12 @@ var applyOptions = (object, options = {}) => {
   const colorLevel = stdoutColor ? stdoutColor.level : 0;
   object.level = options.level === undefined ? colorLevel : options.level;
 };
+
+class Chalk {
+  constructor(options) {
+    return chalkFactory(options);
+  }
+}
 var chalkFactory = (options) => {
   const chalk = (...strings) => strings.join(" ");
   applyOptions(chalk, options);
@@ -21958,12 +21964,14 @@ class CreatePRCommand extends BaseCommand {
 // src/commands/pr/list.command.ts
 class ListPRsCommand extends BaseCommand {
   pullrequestsApi;
+  usersApi;
   contextService;
   name = "list";
   description = "List pull requests";
-  constructor(pullrequestsApi, contextService, output) {
+  constructor(pullrequestsApi, usersApi, contextService, output) {
     super(output);
     this.pullrequestsApi = pullrequestsApi;
+    this.usersApi = usersApi;
     this.contextService = contextService;
   }
   async execute(options, context) {
@@ -21973,6 +21981,7 @@ class ListPRsCommand extends BaseCommand {
     });
     const state = options.state || "OPEN";
     const limit = parseLimit(options.limit);
+    const reviewerQuery = options.mine ? await this.buildMineFilter() : undefined;
     const values = await collectPages({
       limit,
       fetchPage: async (page, pagelen) => {
@@ -21981,7 +21990,11 @@ class ListPRsCommand extends BaseCommand {
           repoSlug: repoContext.repoSlug,
           state
         }, {
-          params: { page, pagelen }
+          params: {
+            page,
+            pagelen,
+            ...reviewerQuery ? { q: reviewerQuery } : {}
+          }
         });
         return response.data;
       }
@@ -21991,6 +22004,9 @@ class ListPRsCommand extends BaseCommand {
         workspace: repoContext.workspace,
         repoSlug: repoContext.repoSlug,
         state,
+        filters: {
+          mine: options.mine === true
+        },
         count: values.length,
         pullRequests: values
       });
@@ -22019,6 +22035,15 @@ class ListPRsCommand extends BaseCommand {
     }
     return text.substring(0, maxLength - 3) + "...";
   }
+  async buildMineFilter() {
+    const response = await this.usersApi.userGet();
+    const userUuid = response.data.uuid;
+    if (!userUuid) {
+      this.output.warning("Could not determine your user UUID. Showing all pull requests.");
+      return;
+    }
+    return `reviewers.uuid="${userUuid}"`;
+  }
 }
 
 // src/commands/pr/view.command.ts
@@ -23667,9 +23692,10 @@ function bootstrap(options = {}) {
   });
   container.register(ServiceTokens.ListPRsCommand, () => {
     const pullrequestsApi = container.resolve(ServiceTokens.PullrequestsApi);
+    const usersApi = container.resolve(ServiceTokens.UsersApi);
     const contextService = container.resolve(ServiceTokens.ContextService);
     const output = container.resolve(ServiceTokens.OutputService);
-    return new ListPRsCommand(pullrequestsApi, contextService, output);
+    return new ListPRsCommand(pullrequestsApi, usersApi, contextService, output);
   });
   container.register(ServiceTokens.ViewPRCommand, () => {
     const pullrequestsApi = container.resolve(ServiceTokens.PullrequestsApi);
@@ -23808,6 +23834,51 @@ function bootstrap(options = {}) {
   return container;
 }
 
+// src/help-text.ts
+function createHelpTextBuilder(noColor) {
+  const passthrough = (t) => t;
+  const chalk2 = new Chalk({ level: noColor ? 0 : 1 });
+  const c = noColor ? { bold: passthrough, dim: passthrough, cyan: passthrough } : { bold: chalk2.bold, dim: chalk2.dim, cyan: chalk2.cyan };
+  return function buildHelpText(config) {
+    const sections = [];
+    if (config.examples?.length) {
+      sections.push(c.bold("Examples:"));
+      for (const example of config.examples) {
+        sections.push(`  ${c.dim("$")} ${example}`);
+      }
+    }
+    if (config.validValues) {
+      for (const [label, values] of Object.entries(config.validValues)) {
+        if (sections.length)
+          sections.push("");
+        sections.push(c.bold(`${label}:`));
+        sections.push(`  ${c.cyan(values.join(", "))}`);
+      }
+    }
+    if (config.defaults) {
+      if (sections.length)
+        sections.push("");
+      sections.push(c.bold("Defaults:"));
+      for (const [key, value] of Object.entries(config.defaults)) {
+        sections.push(`  ${c.bold(`--${key}`)}  ${c.cyan(value)}`);
+      }
+    }
+    if (config.envVars) {
+      if (sections.length)
+        sections.push("");
+      sections.push(c.bold("Environment variables:"));
+      const maxLen = Math.max(...Object.keys(config.envVars).map((k) => k.length));
+      for (const [name, desc] of Object.entries(config.envVars)) {
+        sections.push(`  ${c.bold(name.padEnd(maxLen + 2))}${c.dim(desc)}`);
+      }
+    }
+    return `
+` + sections.join(`
+`) + `
+`;
+  };
+}
+
 // src/cli.ts
 import tabtab3 from "tabtab";
 var require3 = createRequire2(import.meta.url);
@@ -23862,6 +23933,7 @@ function resolveNoColorSetting(argv, env2) {
   return hasNoColorEnv;
 }
 var noColor = resolveNoColorSetting(process.argv, process.env);
+var buildHelpText = createHelpTextBuilder(noColor);
 var container = bootstrap({ noColor });
 function createContext(program2) {
   const opts = program2.opts();
@@ -23891,7 +23963,15 @@ function withGlobalOptions(options, context) {
   };
 }
 var cli = new Command;
-cli.name("bb").description("A command-line interface for Bitbucket Cloud").version(pkg2.version).option("--json", "Output as JSON").option("--no-color", "Disable color output").option("-w, --workspace <workspace>", "Specify workspace").option("-r, --repo <repo>", "Specify repository").action(async () => {
+cli.name("bb").description("A command-line interface for Bitbucket Cloud").version(pkg2.version).option("--json", "Output as JSON").option("--no-color", "Disable color output").option("-w, --workspace <workspace>", "Specify workspace").option("-r, --repo <repo>", "Specify repository").addHelpText("after", buildHelpText({
+  envVars: {
+    BB_USERNAME: "Bitbucket username (fallback for auth login)",
+    BB_API_TOKEN: "Bitbucket API token (fallback for auth login)",
+    NO_COLOR: "Disable color output when set",
+    FORCE_COLOR: "Force color output when set (and not '0')",
+    DEBUG: "Enable HTTP debug logging when 'true'"
+  }
+})).action(async () => {
   cli.outputHelp();
   const versionService = container.resolve(ServiceTokens.VersionService);
   const output = container.resolve(ServiceTokens.OutputService);
@@ -23908,116 +23988,256 @@ 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 using an API token").option("-u, --username <username>", "Bitbucket username").option("-p, --password <password>", "Bitbucket API token").action(async (options) => {
+authCmd.command("login").description("Authenticate with Bitbucket using an API token").option("-u, --username <username>", "Bitbucket username").option("-p, --password <password>", "Bitbucket API token").addHelpText("after", buildHelpText({
+  examples: [
+    "bb auth login -u myuser -p mytoken",
+    "BB_USERNAME=myuser BB_API_TOKEN=mytoken bb auth login"
+  ],
+  envVars: {
+    BB_USERNAME: "Used when --username is not provided",
+    BB_API_TOKEN: "Used when --password is not provided"
+  }
+})).action(async (options) => {
   await runCommand(ServiceTokens.LoginCommand, options, cli);
 });
-authCmd.command("logout").description("Log out of Bitbucket").action(async () => {
+authCmd.command("logout").description("Log out of Bitbucket").addHelpText("after", buildHelpText({ examples: ["bb auth logout"] })).action(async () => {
   await runCommand(ServiceTokens.LogoutCommand, undefined, cli);
 });
-authCmd.command("status").description("Show authentication status").action(async () => {
+authCmd.command("status").description("Show authentication status").addHelpText("after", buildHelpText({
+  examples: ["bb auth status", "bb auth status --json"]
+})).action(async () => {
   await runCommand(ServiceTokens.StatusCommand, undefined, cli);
 });
-authCmd.command("token").description("Print the current access token").action(async () => {
+authCmd.command("token").description("Print the current access token").addHelpText("after", buildHelpText({
+  examples: ["bb auth token", "bb auth token | pbcopy"]
+})).action(async () => {
   await runCommand(ServiceTokens.TokenCommand, undefined, cli);
 });
 cli.addCommand(authCmd);
 var repoCmd = new Command("repo").description("Manage repositories");
-repoCmd.command("clone <repository>").description("Clone a Bitbucket repository").option("-d, --directory <dir>", "Directory to clone into").action(async (repository, options) => {
+repoCmd.command("clone <repository>").description("Clone a Bitbucket repository").option("-d, --directory <dir>", "Directory to clone into").addHelpText("after", buildHelpText({
+  examples: [
+    "bb repo clone workspace/repo-name",
+    "bb repo clone workspace/repo-name -d my-directory"
+  ]
+})).action(async (repository, options) => {
   await runCommand(ServiceTokens.CloneCommand, { repository, ...options }, cli);
 });
-repoCmd.command("create <name>").description("Create a new repository").option("-d, --description <description>", "Repository description").option("--private", "Create a private repository (default)").option("--public", "Create a public repository").option("-p, --project <project>", "Project key").action(async (name, options) => {
+repoCmd.command("create <name>").description("Create a new repository").option("-d, --description <description>", "Repository description").option("--private", "Create a private repository (default)").option("--public", "Create a public repository").option("-p, --project <project>", "Project key").addHelpText("after", buildHelpText({
+  examples: [
+    "bb repo create my-repo",
+    "bb repo create my-repo --public -p PROJ",
+    'bb repo create my-repo -d "My new repository"'
+  ],
+  defaults: { private: "true (visibility is private unless --public)" }
+})).action(async (name, options) => {
   const context = createContext(cli);
   await runCommand(ServiceTokens.CreateRepoCommand, withGlobalOptions({ name, ...options }, context), cli, context);
 });
-repoCmd.command("list").description("List repositories").option("--limit <number>", "Maximum number of repositories to list", "25").action(async (options) => {
+repoCmd.command("list").description("List repositories").option("--limit <number>", "Maximum number of repositories to list", "25").addHelpText("after", buildHelpText({
+  examples: [
+    "bb repo list",
+    "bb repo list --limit 50",
+    "bb repo list --json"
+  ],
+  defaults: { limit: "25" }
+})).action(async (options) => {
   const context = createContext(cli);
   await runCommand(ServiceTokens.ListReposCommand, withGlobalOptions(options, context), cli, context);
 });
-repoCmd.command("view [repository]").description("View repository details").action(async (repository, options) => {
+repoCmd.command("view [repository]").description("View repository details").addHelpText("after", buildHelpText({
+  examples: [
+    "bb repo view",
+    "bb repo view workspace/repo-name",
+    "bb repo view workspace/repo-name --json"
+  ]
+})).action(async (repository, options) => {
   const context = createContext(cli);
   await runCommand(ServiceTokens.ViewRepoCommand, withGlobalOptions({ repository, ...options }, context), cli, context);
 });
-repoCmd.command("delete <repository>").description("Delete a repository").option("-y, --yes", "Skip confirmation prompt").action(async (repository, options) => {
+repoCmd.command("delete <repository>").description("Delete a repository").option("-y, --yes", "Skip confirmation prompt").addHelpText("after", buildHelpText({
+  examples: [
+    "bb repo delete workspace/repo-name",
+    "bb repo delete workspace/repo-name --yes"
+  ]
+})).action(async (repository, options) => {
   const context = createContext(cli);
   await runCommand(ServiceTokens.DeleteRepoCommand, withGlobalOptions({ repository, ...options }, context), cli, context);
 });
 cli.addCommand(repoCmd);
 var prCmd = new Command("pr").description("Manage pull requests");
-prCmd.command("create").description("Create a pull request").option("-t, --title <title>", "Pull request title").option("-b, --body <body>", "Pull request description").option("-s, --source <branch>", "Source branch (default: current branch)").option("-d, --destination <branch>", "Destination branch (default: main)").option("--close-source-branch", "Close source branch after merge").option("--draft", "Create the pull request as draft").action(async (options) => {
+prCmd.command("create").description("Create a pull request").option("-t, --title <title>", "Pull request title").option("-b, --body <body>", "Pull request description").option("-s, --source <branch>", "Source branch (default: current branch)").option("-d, --destination <branch>", "Destination branch (default: main)").option("--close-source-branch", "Close source branch after merge").option("--draft", "Create the pull request as draft").addHelpText("after", buildHelpText({
+  examples: [
+    'bb pr create -t "My PR" -b "Description"',
+    'bb pr create -t "My PR" --draft',
+    'bb pr create -t "My PR" -s feature -d develop',
+    'bb pr create -t "My PR" --close-source-branch'
+  ],
+  defaults: {
+    source: "current git branch",
+    destination: "main"
+  }
+})).action(async (options) => {
   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 (OPEN, MERGED, DECLINED, SUPERSEDED)", "OPEN").option("--limit <number>", "Maximum number of PRs to list", "25").action(async (options) => {
+prCmd.command("list").description("List pull requests").option("-s, --state <state>", "Filter by state (OPEN, MERGED, DECLINED, SUPERSEDED)", "OPEN").option("--limit <number>", "Maximum number of PRs to list", "25").option("--mine", "Show only PRs where you are a reviewer").addHelpText("after", buildHelpText({
+  examples: [
+    "bb pr list",
+    "bb pr list -s MERGED --limit 10",
+    "bb pr list --mine",
+    "bb pr list --json"
+  ],
+  validValues: {
+    "Valid states": ["OPEN", "MERGED", "DECLINED", "SUPERSEDED"]
+  },
+  defaults: { state: "OPEN", limit: "25" }
+})).action(async (options) => {
   const context = createContext(cli);
   await runCommand(ServiceTokens.ListPRsCommand, withGlobalOptions(options, context), cli, context);
 });
-prCmd.command("view <id>").description("View pull request details").action(async (id, options) => {
+prCmd.command("view <id>").description("View pull request details").addHelpText("after", buildHelpText({
+  examples: ["bb pr view 42", "bb pr view 42 --json"]
+})).action(async (id, options) => {
   const context = createContext(cli);
   await runCommand(ServiceTokens.ViewPRCommand, withGlobalOptions({ id, ...options }, context), cli, context);
 });
-prCmd.command("activity <id>").description("Show pull request activity log").option("--limit <number>", "Maximum number of activity entries", "25").option("--type <types>", "Filter activity by type (comma-separated)").action(async (id, options) => {
+prCmd.command("activity <id>").description("Show pull request activity log").option("--limit <number>", "Maximum number of activity entries", "25").option("--type <types>", "Filter activity by type (comma-separated)").addHelpText("after", buildHelpText({
+  examples: [
+    "bb pr activity 42",
+    "bb pr activity 42 --type comment,approval",
+    "bb pr activity 42 --limit 10 --json"
+  ],
+  validValues: {
+    "Valid activity types (comma-separated)": [
+      "comment",
+      "approval",
+      "changes_requested",
+      "merge",
+      "decline",
+      "commit",
+      "update"
+    ]
+  },
+  defaults: { limit: "25" }
+})).action(async (id, options) => {
   const context = createContext(cli);
   await runCommand(ServiceTokens.ActivityPRCommand, withGlobalOptions({ id, ...options }, context), cli, context);
 });
-prCmd.command("checks <id>").description("Show CI/CD checks and build status for a pull request").option("--json", "Output as JSON").action(async (id, options) => {
+prCmd.command("checks <id>").description("Show CI/CD checks and build status for a pull request").option("--json", "Output as JSON").addHelpText("after", buildHelpText({
+  examples: ["bb pr checks 42", "bb pr checks 42 --json"]
+})).action(async (id, options) => {
   const context = createContext(cli);
   await runCommand(ServiceTokens.ChecksPRCommand, withGlobalOptions({ id, ...options }, context), cli, context);
 });
-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) => {
+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").addHelpText("after", buildHelpText({
+  examples: [
+    'bb pr edit 42 -t "New title"',
+    'bb pr edit 42 -b "Updated description"',
+    "bb pr edit 42 -F description.md",
+    "bb pr edit"
+  ]
+})).action(async (id, options) => {
   const context = createContext(cli);
   await runCommand(ServiceTokens.EditPRCommand, withGlobalOptions({ id, ...options }, context), cli, context);
 });
-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) => {
+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").addHelpText("after", buildHelpText({
+  examples: [
+    "bb pr merge 42",
+    "bb pr merge 42 --strategy squash --close-source-branch",
+    'bb pr merge 42 -m "Merge feature X"'
+  ],
+  validValues: {
+    "Valid merge strategies": [
+      "merge_commit",
+      "squash",
+      "fast_forward",
+      "squash_fast_forward",
+      "rebase_fast_forward",
+      "rebase_merge"
+    ]
+  }
+})).action(async (id, options) => {
   const context = createContext(cli);
   await runCommand(ServiceTokens.MergePRCommand, withGlobalOptions({ id, ...options }, context), cli, context);
 });
-prCmd.command("approve <id>").description("Approve a pull request").action(async (id, options) => {
+prCmd.command("approve <id>").description("Approve a pull request").addHelpText("after", buildHelpText({ examples: ["bb pr approve 42"] })).action(async (id, options) => {
   const context = createContext(cli);
   await runCommand(ServiceTokens.ApprovePRCommand, withGlobalOptions({ id, ...options }, context), cli, context);
 });
-prCmd.command("decline <id>").description("Decline a pull request").action(async (id, options) => {
+prCmd.command("decline <id>").description("Decline a pull request").addHelpText("after", buildHelpText({ examples: ["bb pr decline 42"] })).action(async (id, options) => {
   const context = createContext(cli);
   await runCommand(ServiceTokens.DeclinePRCommand, withGlobalOptions({ id, ...options }, context), cli, context);
 });
-prCmd.command("ready <id>").description("Mark a draft pull request as ready for review").action(async (id, options) => {
+prCmd.command("ready <id>").description("Mark a draft pull request as ready for review").addHelpText("after", buildHelpText({ examples: ["bb pr ready 42"] })).action(async (id, options) => {
   const context = createContext(cli);
   await runCommand(ServiceTokens.ReadyPRCommand, withGlobalOptions({ id, ...options }, context), cli, context);
 });
-prCmd.command("checkout <id>").description("Checkout a pull request locally").action(async (id, options) => {
+prCmd.command("checkout <id>").description("Checkout a pull request locally").addHelpText("after", buildHelpText({ examples: ["bb pr checkout 42"] })).action(async (id, options) => {
   const context = createContext(cli);
   await runCommand(ServiceTokens.CheckoutPRCommand, withGlobalOptions({ id, ...options }, context), cli, context);
 });
-prCmd.command("diff [id]").description("View pull request diff").option("--color <when>", "Colorize output (auto, always, never)", "auto").option("--name-only", "Show only names of changed files").option("--stat", "Show diffstat").option("--web", "Open diff in web browser").action(async (id, options) => {
+prCmd.command("diff [id]").description("View pull request diff").option("--color <when>", "Colorize output", "auto").option("--name-only", "Show only names of changed files").option("--stat", "Show diffstat").option("--web", "Open diff in web browser").addHelpText("after", buildHelpText({
+  examples: [
+    "bb pr diff 42",
+    "bb pr diff 42 --stat",
+    "bb pr diff 42 --name-only",
+    "bb pr diff --web",
+    "bb pr diff 42 --color always"
+  ],
+  validValues: {
+    "Valid --color values": ["auto", "always", "never"]
+  },
+  defaults: { color: "auto" }
+})).action(async (id, options) => {
   const context = createContext(cli);
   await runCommand(ServiceTokens.DiffPRCommand, withGlobalOptions({ id, ...options }, context), cli, context);
 });
 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)").option("--no-truncate", "Show full comment content without truncation").action(async (id, options) => {
+prCommentsCmd.command("list <id>").description("List comments on a pull request").option("--limit <number>", "Maximum number of comments (default: 25)").option("--no-truncate", "Show full comment content without truncation").addHelpText("after", buildHelpText({
+  examples: [
+    "bb pr comments list 42",
+    "bb pr comments list 42 --no-truncate",
+    "bb pr comments list 42 --limit 50 --json"
+  ],
+  defaults: { limit: "25" }
+})).action(async (id, options) => {
   const context = createContext(cli);
   await runCommand(ServiceTokens.ListCommentsPRCommand, withGlobalOptions({ id, ...options }, context), cli, context);
 });
-prCommentsCmd.command("add <id> <message>").description("Add a comment to a pull request").option("--file <path>", "File path in the diff for inline comment").option("--line-to <number>", "Line number in the new file version").option("--line-from <number>", "Line number in the old file version").action(async (id, message, options) => {
+prCommentsCmd.command("add <id> <message>").description("Add a comment to a pull request").option("--file <path>", "File path in the diff for inline comment").option("--line-to <number>", "Line number in the new file version").option("--line-from <number>", "Line number in the old file version").addHelpText("after", buildHelpText({
+  examples: [
+    'bb pr comments add 42 "LGTM"',
+    'bb pr comments add 42 "Fix this" --file src/main.ts --line-to 10'
+  ]
+})).action(async (id, message, options) => {
   const context = createContext(cli);
   await runCommand(ServiceTokens.CommentPRCommand, withGlobalOptions({ id, message, ...options }, context), cli, context);
 });
-prCommentsCmd.command("edit <pr-id> <comment-id> <message>").description("Edit a comment on a pull request").action(async (prId, commentId, message, options) => {
+prCommentsCmd.command("edit <pr-id> <comment-id> <message>").description("Edit a comment on a pull request").addHelpText("after", buildHelpText({
+  examples: ['bb pr comments edit 42 12345 "Updated comment"']
+})).action(async (prId, commentId, message, options) => {
   const context = createContext(cli);
   await runCommand(ServiceTokens.EditCommentPRCommand, withGlobalOptions({ prId, commentId, message }, context), cli, context);
 });
-prCommentsCmd.command("delete <pr-id> <comment-id>").description("Delete a comment on a pull request").action(async (prId, commentId, options) => {
+prCommentsCmd.command("delete <pr-id> <comment-id>").description("Delete a comment on a pull request").addHelpText("after", buildHelpText({
+  examples: ["bb pr comments delete 42 12345"]
+})).action(async (prId, commentId, options) => {
   const context = createContext(cli);
   await runCommand(ServiceTokens.DeleteCommentPRCommand, withGlobalOptions({ prId, commentId }, context), cli, context);
 });
 var prReviewersCmd = new Command("reviewers").description("Manage pull request reviewers");
-prReviewersCmd.command("list <id>").description("List reviewers on a pull request").action(async (id, options) => {
+prReviewersCmd.command("list <id>").description("List reviewers on a pull request").addHelpText("after", buildHelpText({
+  examples: ["bb pr reviewers list 42", "bb pr reviewers list 42 --json"]
+})).action(async (id, options) => {
   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").action(async (id, username, options) => {
+prReviewersCmd.command("add <id> <username>").description("Add a reviewer to a pull request").addHelpText("after", buildHelpText({ examples: ["bb pr reviewers add 42 jdoe"] })).action(async (id, username, options) => {
   const context = createContext(cli);
   await runCommand(ServiceTokens.AddReviewerPRCommand, withGlobalOptions({ id, username, ...options }, context), cli, context);
 });
-prReviewersCmd.command("remove <id> <username>").description("Remove a reviewer from a pull request").action(async (id, username, options) => {
+prReviewersCmd.command("remove <id> <username>").description("Remove a reviewer from a pull request").addHelpText("after", buildHelpText({ examples: ["bb pr reviewers remove 42 jdoe"] })).action(async (id, username, options) => {
   const context = createContext(cli);
   await runCommand(ServiceTokens.RemoveReviewerPRCommand, withGlobalOptions({ id, username, ...options }, context), cli, context);
 });
@@ -24025,21 +24245,46 @@ cli.addCommand(prCmd);
 prCmd.addCommand(prCommentsCmd);
 prCmd.addCommand(prReviewersCmd);
 var configCmd = new Command("config").description("Manage configuration");
-configCmd.command("get <key>").description("Get a configuration value").action(async (key) => {
+configCmd.command("get <key>").description("Get a configuration value").addHelpText("after", buildHelpText({
+  examples: ["bb config get defaultWorkspace"],
+  validValues: {
+    "Readable config keys": [
+      "username",
+      "defaultWorkspace",
+      "skipVersionCheck",
+      "versionCheckInterval"
+    ]
+  }
+})).action(async (key) => {
   await runCommand(ServiceTokens.GetConfigCommand, { key }, cli);
 });
-configCmd.command("set <key> <value>").description("Set a configuration value").action(async (key, value) => {
+configCmd.command("set <key> <value>").description("Set a configuration value").addHelpText("after", buildHelpText({
+  examples: [
+    "bb config set defaultWorkspace my-workspace",
+    "bb config set skipVersionCheck true",
+    "bb config set versionCheckInterval 86400"
+  ],
+  validValues: {
+    "Settable config keys": [
+      "defaultWorkspace (string)",
+      "skipVersionCheck (true/false)",
+      "versionCheckInterval (positive integer, seconds)"
+    ]
+  }
+})).action(async (key, value) => {
   await runCommand(ServiceTokens.SetConfigCommand, { key, value }, cli);
 });
-configCmd.command("list").description("List all configuration values").action(async () => {
+configCmd.command("list").description("List all configuration values").addHelpText("after", buildHelpText({
+  examples: ["bb config list", "bb config list --json"]
+})).action(async () => {
   await runCommand(ServiceTokens.ListConfigCommand, undefined, cli);
 });
 cli.addCommand(configCmd);
 var completionCmd = new Command("completion").description("Shell completion utilities");
-completionCmd.command("install").description("Install shell completions for bash, zsh, or fish").action(async () => {
+completionCmd.command("install").description("Install shell completions for bash, zsh, or fish").addHelpText("after", buildHelpText({ examples: ["bb completion install"] })).action(async () => {
   await runCommand(ServiceTokens.InstallCompletionCommand, undefined, cli);
 });
-completionCmd.command("uninstall").description("Uninstall shell completions").action(async () => {
+completionCmd.command("uninstall").description("Uninstall shell completions").addHelpText("after", buildHelpText({ examples: ["bb completion uninstall"] })).action(async () => {
   await runCommand(ServiceTokens.UninstallCompletionCommand, undefined, cli);
 });
 cli.addCommand(completionCmd);

package/package.json

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