Metadata-Version: 2.4
Name: stubborn-status
Version: 0.10.0b1
Summary: Aggregate federated Stubborn doctor reports for terminal, CI, and IDE consumers
Project-URL: Homepage, https://github.com/stubborn-ai/stubborn-status
Project-URL: Repository, https://github.com/stubborn-ai/stubborn-status
Project-URL: Documentation, https://github.com/stubborn-ai/stubborn-hub/blob/main/docs/DEMO-LAUNCHERS.md
Author: Stubborn contributors
License-Expression: MIT
License-File: LICENSE
Keywords: devtools,diagnostics,doctor,scip,stubborn
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
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
Requires-Dist: typer<1.0,>=0.12
Provides-Extra: dev
Requires-Dist: pytest<9.0,>=8.0; extra == 'dev'
Requires-Dist: ruff<1,>=0.9; extra == 'dev'
Description-Content-Type: text/markdown

# stubborn-status

**Beta `0.10.0b1`** — aggregate federated `doctor --json` reports from Stubborn ecosystem packages.

[![PyPI](https://img.shields.io/pypi/v/stubborn-status)](https://pypi.org/project/stubborn-status/)

Part of [stubborn-ai](https://github.com/stubborn-ai). Spec: [ADR-016](https://github.com/stubborn-ai/stubborn/blob/main/docs/adr/ADR-016-doctor-status-aggregation.md).

## Install

```bash
pip install stubborn-status
```

Requires sibling CLIs on `PATH` (`stubborn`, `stubborn-mcp`, `stubborn-watch`, …).

## Usage

```bash
# Human-readable merged report
stubborn-status

# Machine-readable for CI / IDE bridges
stubborn-status --json

# Require optional doctors in the aggregate exit code
stubborn-status --require stubborn-mcp,stubborn-watch

# Forward DB path to doctors that accept --db
stubborn-status --db metadata/symbols.db
```

## Design

- **Subprocess only** — never imports `stubborn_mcp` or other sibling packages
- **Graceful degradation** — missing optional packages appear as `not_installed`
- **Source attribution** — every check keeps its owning package label
- **Read-only** — doctors are invoked with `--json`; no ingest, merge, or schema migration

## Development

```bash
pip install -e '.[dev]'
pytest
```

See [CHANGELOG](CHANGELOG.md) and [docs/RELEASE.md](docs/RELEASE.md).
