Metadata-Version: 2.1
Name: bub-social-coding
Version: 0.1.0
Summary: Social coding control-plane plugin for Bub.
Author: Bub contributors
License: Apache-2.0
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Project-URL: Homepage, https://github.com/ximenzun/bub-social-coding
Project-URL: Repository, https://github.com/ximenzun/bub-social-coding
Project-URL: Documentation, https://github.com/ximenzun/bub
Project-URL: Issues, https://github.com/ximenzun/bub-social-coding/issues
Requires-Python: <4.0,>=3.12
Requires-Dist: bub>=0.3.0a1
Requires-Dist: pydantic>=2.0.0
Requires-Dist: pydantic-settings>=2.0.0
Requires-Dist: pyyaml>=6.0.0
Description-Content-Type: text/markdown

# bub-social-coding

Social coding control-plane plugin for [Bub](https://github.com/ximenzun/bub).

## Install

Once published:

```bash
uv pip install bub-social-coding
```

For local development next to the Bub repo:

```bash
cd /path/to/bub-social-coding
uv sync
```

## What It Adds

- repo binding and repo control commands for social sessions
- git workflow helpers exposed through slash commands
- bundled skills for repo control, git workflow, and social coding policy

## Usage

Once installed, Bub auto-discovers the plugin through entry points.

The plugin adds slash commands like:

- `/repo`
- `/git`

For local validation:

```bash
uv run pytest -q
uv run bub hooks
```

## Release

Publishing is driven by GitHub Actions.
Create a GitHub Release on `main` with a tag like `v0.1.0` or `0.1.0`, and the release workflow will:

1. normalize the tag to a package version
2. build the sdist and wheel
3. publish to PyPI through Trusted Publishing (GitHub OIDC)

No long-lived `PYPI_TOKEN` secret is required when PyPI Trusted Publisher is configured for `.github/workflows/on-release-main.yml`.

## Contributing

See [CONTRIBUTING.md](./CONTRIBUTING.md) for the local workflow, verification commands, and pull request process.
