Metadata-Version: 2.4
Name: wellman
Version: 0.20.32
Summary: Wellmanifest governance gate runtime — deterministic policy-as-code checker
Author: wellmanifest
License: MIT
Keywords: governance,policy-as-code,wellmanifest,standard
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.11
Description-Content-Type: text/markdown

# wellman

Wellmanifest governance gate runtime — deterministic policy-as-code checker.

Distributes `governance_check.py` as an installable Python package instead of
vendoring 187KB+ scripts into every adopting repository.

## Install

```bash
uv add --group governance wellman
# or
pip install wellman
```

## Usage

```bash
# CLI
wellman check --root /path/to/repo

# Module
python -m wellman check --root /path/to/repo
```

```python
# Programmatic
from wellman.check import run_check
exit_code = run_check(root="/path/to/repo")
```

## Pre-commit hook integration

```bash
# In .githooks/pre-commit:
REQUIRED=$(python3 -c "import tomllib; print(tomllib.load(open('pyproject.toml','rb'))['tool']['wellmanifest']['standard'])")
uv pip install "wellman==${REQUIRED}" --quiet
python -m wellman check --root . --preflight
```

## CI reusable workflow

```yaml
# .github/workflows/governance.yml
jobs:
  governance:
    uses: wellmanifest/new-project/.github/workflows/governance-gate-reusable.yml@v0.20.32
```

## Source

Part of [wellmanifest/new-project](https://github.com/wellmanifest/new-project).
