@proggarapsody/bitbottle 1.16.0 → 1.17.0

package/README.md

@@ -82,6 +82,9 @@ Credentials are stored in `~/.config/bitbottle/hosts.yml`. Inside a git repo wit
 | `webhook` | `list` `view` `create` `delete` |
 | `commit` | `log` `view` |
 | `pipeline` | `list` `view` `run` _(Cloud only)_ |
+| `workspace` | `list` _(Cloud only)_ |
+| `project` | `list WORKSPACE` _(Cloud only)_ |
+| `issue` | `list` `view` `create` `close` _(Cloud only)_ |
 | `api` | Raw REST passthrough with pagination, `--jq`, variable expansion |
 | `alias` | Custom command shortcuts |
 | `config` | Editor, pager, git protocol per-host |
@@ -127,6 +130,24 @@ bitbottle branch create MYPROJ/my-service feature/x --start-at main
 bitbottle branch delete MYPROJ/my-service feature/x
 ```
 
+#### Branch protection _(Bitbucket Server / DC only)_
+
+Branch restrictions on Bitbucket Server / DC. Cloud has a different model
+that isn't wired up yet — invocations against Cloud return a typed
+"unsupported on host" error.
+
+```bash
+bitbottle branch protect list   MYPROJ/my-service
+bitbottle branch protect create MYPROJ/my-service \
+  --type fast-forward-only --branch main \
+  --user alice --group devs
+bitbottle branch protect delete MYPROJ/my-service 42
+```
+
+`--type` accepts `read-only`, `no-deletes`, `fast-forward-only`, or
+`pull-request-only`. Pass exactly one of `--branch NAME` (literal branch)
+or `--pattern GLOB` (e.g. `release/*`).
+
 ### Pipelines _(Cloud only)_
 
 ```bash
@@ -196,6 +217,21 @@ bitbottle repo fork myworkspace/my-service --into otherws --name my-fork
 Data Center, which has no fork primitive in its REST API. Both `rename` and
 `fork` accept `--json fields` and `--jq expr` for structured output.
 
+### Workspaces & Projects (Cloud only)
+
+```bash
+# Workspaces the authenticated user belongs to
+bitbottle workspace list
+bitbottle workspace list --json slug,name --jq '.[].slug'
+
+# Projects within a workspace
+bitbottle project list myworkspace
+bitbottle project list myworkspace --limit 100
+```
+
+Both commands surface a typed unsupported-capability error against
+Bitbucket Server / Data Center hosts (workspaces are a Cloud concept).
+
 ### Raw API
 
 ```bash
@@ -285,6 +321,20 @@ bitbottle completion --shell powershell >> $PROFILE
 
 Full list in [`internal/envvars/envvars.go`](internal/envvars/envvars.go).
 
+## Colour & pager
+
+State columns in TTY tables are colourised: `OPEN` / `SUCCESSFUL` /
+active webhooks render green; `MERGED` magenta; `DECLINED` /
+`SUPERSEDED` / `FAILED` / `ERROR` / `STOPPED` / inactive webhooks red;
+`IN_PROGRESS` / `PENDING` yellow. Colour applies to TTY table output
+only — JSON (`--json`) and piped output stay raw.
+
+Disable colour with the global `--no-color` flag or by setting
+`NO_COLOR=1` in the environment. JSON output is never colourised.
+
+Long-output commands (`pr diff`, `commit log`) pipe through `$PAGER`
+when stdout is a TTY (default `less -FRX`). Set `PAGER=cat` to disable.
+
 ---
 
 ## Contributing

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proggarapsody/bitbottle",
-  "version": "1.16.0",
+  "version": "1.17.0",
   "description": "Bitbucket CLI for Server/Data Center and Cloud — npm wrapper for bitbottle",
   "keywords": [
     "mcp",