@pilatos/bitbucket-cli 1.18.0 → 1.19.0

package/README.md

@@ -93,7 +93,7 @@ bb browse src/cli.ts:20       # open a file at a specific line
 bb config set defaultWorkspace myworkspace
 ```
 
-**Global options:** `--json [fields]`, `--jq <expression>`, `--no-color`, `-w, --workspace`, `-r, --repo`
+**Global options** (work on every command): `--json [fields]`, `--jq`, `--no-color`, `--no-unicode`, `--no-truncate`, `--limit`, `--all`, `--locale`, `-w, --workspace`, `-r, --repo`. Full reference: [Global Flags](https://bitbucket-cli.paulvanderlei.com/reference/global-flags/).
 
 ### Scripting with `--json` and `--jq`
 
@@ -135,13 +135,16 @@ Full documentation: **[bitbucket-cli.paulvanderlei.com](https://bitbucket-cli.pa
 
 ## Environment Variables
 
-| Variable       | Description                                                |
-| -------------- | ---------------------------------------------------------- |
-| `BB_USERNAME`  | Bitbucket username (fallback for `bb auth login`)          |
-| `BB_API_TOKEN` | Bitbucket API token (fallback for `bb auth login`; for CI) |
-| `DEBUG`        | Enable HTTP debug logging when set to `true`               |
-| `NO_COLOR`     | Disable color output when set                              |
-| `FORCE_COLOR`  | Force color output when set (and not `0`)                  |
+| Variable        | Description                                                            |
+| --------------- | ---------------------------------------------------------------------- |
+| `BB_USERNAME`   | Bitbucket username (fallback for `bb auth login`)                      |
+| `BB_API_TOKEN`  | Bitbucket API token (fallback for `bb auth login`; for CI)             |
+| `BB_WORKSPACE`  | Default workspace; overrides `defaultWorkspace` config                 |
+| `BB_LOCALE`     | BCP-47 locale for date/time formatting (e.g. `de-DE`); `--locale` wins |
+| `BB_NO_UNICODE` | Use ASCII fallbacks for symbols when set (any non-empty value)         |
+| `DEBUG`         | Enable HTTP debug logging — must equal exactly `true`                  |
+| `NO_COLOR`      | Disable color output when set                                          |
+| `FORCE_COLOR`   | Force color output when set (and not `0`)                              |
 
 Full reference: [Environment variables](https://bitbucket-cli.paulvanderlei.com/reference/environment-variables/).
 

package/dist/index.js

@@ -17941,8 +17941,7 @@ class ContextService {
       };
     }
     if (options.repo) {
-      const config = await this.configService.getConfig();
-      const workspace = gitContext?.workspace || config.defaultWorkspace;
+      const workspace = gitContext?.workspace ?? await this.resolveDefaultWorkspace();
       if (workspace) {
         return {
           context: { workspace, repoSlug: options.repo },
@@ -17953,6 +17952,21 @@ class ContextService {
     }
     return gitResult;
   }
+  async resolveDefaultWorkspace() {
+    const fromEnv = process.env.BB_WORKSPACE;
+    if (typeof fromEnv === "string") {
+      const trimmed = fromEnv.trim();
+      if (trimmed.length > 0) {
+        return trimmed;
+      }
+    }
+    const config = await this.configService.getConfig();
+    const fromConfig = config.defaultWorkspace;
+    if (typeof fromConfig === "string" && fromConfig.length > 0) {
+      return fromConfig;
+    }
+    return;
+  }
   async requireRepoContext(options) {
     const result = await this.resolveRepoContext(options);
     if (!result.context) {
@@ -17990,9 +18004,9 @@ class ContextService {
     if (explicit && explicit.length > 0) {
       return explicit;
     }
-    const config = await this.configService.getConfig();
-    if (config.defaultWorkspace && config.defaultWorkspace.length > 0) {
-      return config.defaultWorkspace;
+    const fallback = await this.resolveDefaultWorkspace();
+    if (fallback) {
+      return fallback;
     }
     throw new BBError({
       code: 6002 /* CONTEXT_WORKSPACE_NOT_FOUND */,
@@ -31501,14 +31515,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 [fields]", "Output as JSON; optionally project to a comma-separated field list (e.g. number,title,author.display_name)").option("--jq <expression>", `Filter the JSON output through a jq expression \u2014 runs in-process via embedded jq, requires --json (e.g. '.pullRequests[] | select(.state == "OPEN") | .title')`).option("--no-color", "Disable color output").option("--no-unicode", "Use ASCII fallbacks for symbols (separators, arrows, status icons) \u2014 also enabled by BB_NO_UNICODE").option("--no-truncate", "Show full values in table output without truncation").option("--locale <locale>", "BCP-47 locale tag for date/time formatting (e.g. de-DE, ja-JP). Falls back to BB_LOCALE, then LC_TIME/LC_ALL/LANG, then en-US.").option("-w, --workspace <workspace>", "Specify workspace").option("-r, --repo <repo>", "Specify repository").addHelpText("after", buildHelpText({
+cli.name("bb").description("A command-line interface for Bitbucket Cloud").version(pkg2.version).option("--json [fields]", "Output as JSON; optionally project to a comma-separated field list (e.g. number,title,author.display_name)").option("--jq <expression>", `Filter the JSON output through a jq expression \u2014 runs in-process via embedded jq, requires --json (e.g. '.pullRequests[] | select(.state == "OPEN") | .title')`).option("--no-color", "Disable color output").option("--no-unicode", "Use ASCII fallbacks for symbols (separators, arrows, status icons) \u2014 also enabled by BB_NO_UNICODE").option("--no-truncate", "Show full values in table output without truncation").option("--locale <locale>", "BCP-47 locale tag for date/time formatting (e.g. de-DE, ja-JP). Falls back to BB_LOCALE, then LC_TIME/LC_ALL/LANG, then en-US.").option("-w, --workspace <workspace>", "Specify workspace (falls back to BB_WORKSPACE, then config defaultWorkspace)").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)",
+    BB_WORKSPACE: "Default workspace (overrides config.defaultWorkspace; --workspace still wins)",
     NO_COLOR: "Disable color output when set",
     FORCE_COLOR: "Force color output when set (and not '0')",
     BB_NO_UNICODE: "Use ASCII fallbacks for symbols when set (any non-empty value)",
-    DEBUG: "Enable HTTP debug logging when 'true'",
+    DEBUG: "Enable HTTP debug logging when exactly 'true'",
     BB_LOCALE: "BCP-47 locale tag for date/time formatting; --locale takes precedence"
   },
   seeAlso: [
@@ -32118,5 +32133,5 @@ if (typeof Bun === "undefined") {
 }
 cli.parse(process.argv);
 
-//# debugId=B7A5A47929AA84A364756E2164756E21
+//# debugId=C24B0C4332F9755664756E2164756E21
 //# sourceMappingURL=index.js.map