Metadata-Version: 2.4
Name: plato-deadband
Version: 0.1.0
Summary: Deadband Protocol — P0 rock, P1 channel, P2 optimize priority governance
Author-email: SuperInstance Fleet <fleet@cocapn.ai>
License: MIT
Project-URL: Homepage, https://github.com/SuperInstance/plato-deadband
Project-URL: Repository, https://github.com/SuperInstance/plato-deadband
Keywords: plato,deadband,priority,governance,ai,scheduling
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# plato-deadband

Deadband Protocol — P0 rock, P1 channel, P2 optimize priority governance.

Part of the [PLATO framework](https://github.com/SuperInstance) — deterministic AI knowledge management through tile-based architecture.

## Installation

```bash
pip install plato-deadband
```

## Usage

```python
from plato_deadband import DeadbandEngine, DeadbandItem, Priority

engine = DeadbandEngine()

engine.submit(DeadbandItem(id="fix-bug", priority=Priority.P0, urgency=1.0))
engine.submit(DeadbandItem(id="refactor", priority=Priority.P2, urgency=0.5))
engine.submit(DeadbandItem(id="add-tests", priority=Priority.P1, urgency=0.8))

item = engine.next()
print(item.id)  # "fix-bug" — P0 always first

stats = engine.stats
# {"queued": 2, "resolved": 0, "by_priority": {"P0": 0, "P1": 1, "P2": 1}}
```

## The Deadband Protocol

Three levels of strict priority. Never skip a level.

- **P0 Rock** — Blocks everything. Critical issues that must be resolved before any other work.
- **P1 Channel** — Gets scheduled next. Important work queued after all P0s clear.
- **P2 Optimize** — Deferred. Nice-to-haves that run when no higher-priority work exists.

The discipline IS the intelligence.

Zero external dependencies. Compatible with Python 3.8+.

[GitHub](https://github.com/SuperInstance/plato-deadband)
