bbdc-cli 0.3.1__tar.gz → 0.4.0__tar.gz

{bbdc_cli-0.3.1 → bbdc_cli-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bbdc-cli
-Version: 0.3.1
+Version: 0.4.0
 Summary: Typer CLI for Bitbucket Data Center
 Project-URL: Repository, https://github.com/marcosgalleterobbva/bb-cli
 Keywords: bitbucket,cli,typer,data-center,server
@@ -79,19 +79,43 @@ export BITBUCKET_API_TOKEN="YOUR_TOKEN"
 
 ```bash
 bbdc doctor
+# machine-readable output
+bbdc doctor --json
 ```
 
 If this succeeds, your base URL + token are working.
 
+Optional (for account profile/settings lookups):
+
+- `BITBUCKET_USER_SLUG`: your Bitbucket user slug
+
 ## Common commands
 
 Show help:
 
 ```bash
 bbdc --help
+bbdc account --help
 bbdc pr --help
 ```
 
+Get information about your authenticated account:
+
+```bash
+# consolidated snapshot (recent repos + SSH keys + GPG keys)
+bbdc account me
+
+# include user profile and settings when your slug is known
+bbdc account me --user-slug your.user --include-settings
+
+# raw account endpoint calls
+bbdc account recent-repos
+bbdc account ssh-keys
+bbdc account gpg-keys
+bbdc account user --user-slug your.user
+bbdc account settings --user-slug your.user
+```
+
 List pull requests:
 
 ```bash
@@ -162,6 +186,24 @@ bbdc pr review complete -p GL_KAIF_APP-ID-2866825_DSG -r mercury-viz 123 --comme
 bbdc pr comments add -p GL_KAIF_APP-ID-2866825_DSG -r mercury-viz 123 --text "LGTM"
 ```
 
+## Batch operations
+
+Batch commands live under `bbdc pr batch ...` and read a JSON list of items from `--file` (or `-` for stdin). You can
+provide `--project` and `--repo` as defaults for each item.
+
+Example batch approvals (`approve.json`):
+
+```json
+[
+  {"pr_id": 123},
+  {"pr_id": 456}
+]
+```
+
+```bash
+bbdc pr batch approve -p GL_KAIF_APP-ID-2866825_DSG -r mercury-viz -f approve.json
+```
+
 Diffs and commits:
 
 ```bash
@@ -172,6 +214,20 @@ bbdc pr diff-file -p GL_KAIF_APP-ID-2866825_DSG -r mercury-viz 123 src/main.py
 
 See the full command reference in `docs/CLI.md` and usage examples in `docs/examples.md`.
 
+## Codex integration
+
+If teammates will use this through Codex with natural language:
+
+1. Distribute this CLI through PyPI (`bbdc-cli`).
+2. Distribute the Codex skill separately (for example, git repo cloned into `$CODEX_HOME/skills/bbdc-cli`).
+3. Keep the skill's command inventory synced with this repo's `bbdc_cli/__main__.py`.
+
+Recommended split of responsibilities:
+- This repo: command behavior, API semantics, package distribution.
+- Skill repo: natural-language intent mapping, execution policy, Codex-specific prompting.
+
+This separation is the correct approach and avoids coupling Codex behavior to package release timing.
+
 ## Troubleshooting
 
 `BITBUCKET_SERVER` must end with `/rest`.

{bbdc_cli-0.3.1 → bbdc_cli-0.4.0}/README.md

@@ -60,19 +60,43 @@ export BITBUCKET_API_TOKEN="YOUR_TOKEN"
 
 ```bash
 bbdc doctor
+# machine-readable output
+bbdc doctor --json
 ```
 
 If this succeeds, your base URL + token are working.
 
+Optional (for account profile/settings lookups):
+
+- `BITBUCKET_USER_SLUG`: your Bitbucket user slug
+
 ## Common commands
 
 Show help:
 
 ```bash
 bbdc --help
+bbdc account --help
 bbdc pr --help
 ```
 
+Get information about your authenticated account:
+
+```bash
+# consolidated snapshot (recent repos + SSH keys + GPG keys)
+bbdc account me
+
+# include user profile and settings when your slug is known
+bbdc account me --user-slug your.user --include-settings
+
+# raw account endpoint calls
+bbdc account recent-repos
+bbdc account ssh-keys
+bbdc account gpg-keys
+bbdc account user --user-slug your.user
+bbdc account settings --user-slug your.user
+```
+
 List pull requests:
 
 ```bash
@@ -143,6 +167,24 @@ bbdc pr review complete -p GL_KAIF_APP-ID-2866825_DSG -r mercury-viz 123 --comme
 bbdc pr comments add -p GL_KAIF_APP-ID-2866825_DSG -r mercury-viz 123 --text "LGTM"
 ```
 
+## Batch operations
+
+Batch commands live under `bbdc pr batch ...` and read a JSON list of items from `--file` (or `-` for stdin). You can
+provide `--project` and `--repo` as defaults for each item.
+
+Example batch approvals (`approve.json`):
+
+```json
+[
+  {"pr_id": 123},
+  {"pr_id": 456}
+]
+```
+
+```bash
+bbdc pr batch approve -p GL_KAIF_APP-ID-2866825_DSG -r mercury-viz -f approve.json
+```
+
 Diffs and commits:
 
 ```bash
@@ -153,6 +195,20 @@ bbdc pr diff-file -p GL_KAIF_APP-ID-2866825_DSG -r mercury-viz 123 src/main.py
 
 See the full command reference in `docs/CLI.md` and usage examples in `docs/examples.md`.
 
+## Codex integration
+
+If teammates will use this through Codex with natural language:
+
+1. Distribute this CLI through PyPI (`bbdc-cli`).
+2. Distribute the Codex skill separately (for example, git repo cloned into `$CODEX_HOME/skills/bbdc-cli`).
+3. Keep the skill's command inventory synced with this repo's `bbdc_cli/__main__.py`.
+
+Recommended split of responsibilities:
+- This repo: command behavior, API semantics, package distribution.
+- Skill repo: natural-language intent mapping, execution policy, Codex-specific prompting.
+
+This separation is the correct approach and avoids coupling Codex behavior to package release timing.
+
 ## Troubleshooting
 
 `BITBUCKET_SERVER` must end with `/rest`.