@proggarapsody/bitbottle 1.15.0 → 1.17.0

package/README.md

@@ -76,12 +76,15 @@ Credentials are stored in `~/.config/bitbottle/hosts.yml`. Inside a git repo wit
 |---|---|
 | `auth` | `login` `logout` `status` `token` `refresh` |
 | `pr` | `list` `view` `create` `merge` `approve` `unapprove` `diff` `checkout` `edit` `decline` `ready` `request-review` `comment` |
-| `repo` | `list` `view` `create` `delete` `clone` `set-default` |
+| `repo` | `list` `view` `create` `delete` `clone` `set-default` `rename` `fork` _(Cloud)_ |
 | `branch` | `list` `create` `delete` `checkout` |
 | `tag` | `list` `create` `delete` |
 | `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
@@ -179,6 +200,38 @@ Event keys differ between backends:
 from a file. Trailing newlines from stdin / file are trimmed. Webhook
 secrets are write-only — neither backend returns them on read.
 
+### Repo extras
+
+```bash
+# Rename (both backends — slug derives from new name on Cloud).
+# --confirm is required on non-TTY because the slug change breaks existing
+# clones' origin URL — run `git remote set-url origin ...` after.
+bitbottle repo rename MYPROJ/my-service my-service-v2 --confirm
+
+# Fork into another workspace (Bitbucket Cloud only)
+bitbottle repo fork myworkspace/my-service --into otherws
+bitbottle repo fork myworkspace/my-service --into otherws --name my-fork
+```
+
+`repo fork` returns a typed unsupported-capability error on Bitbucket Server /
+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
@@ -268,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.15.0",
+  "version": "1.17.0",
   "description": "Bitbucket CLI for Server/Data Center and Cloud — npm wrapper for bitbottle",
   "keywords": [
     "mcp",