Metadata-Version: 2.4
Name: plato-temporal-validity
Version: 0.1.0
Summary: Temporal validity — Valid, Grace, Expired lifecycle with refresh and decay
Author-email: SuperInstance Fleet <fleet@cocapn.ai>
License: MIT
Project-URL: Homepage, https://github.com/SuperInstance/plato-temporal-validity
Project-URL: Repository, https://github.com/SuperInstance/plato-temporal-validity
Keywords: plato,temporal,validity,lifecycle,ai,knowledge
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-temporal-validity

Temporal validity — Valid, Grace, Expired lifecycle with refresh and decay.

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

## Installation

```bash
pip install plato-temporal-validity
```

## Usage

```python
from plato_temporal_validity import TemporalValidity

tv = TemporalValidity.fresh(ttl_days=7)

print(tv.state)          # TemporalState.VALID
print(tv.decay_factor)   # 1.0 (full score)
print(tv.is_valid())     # True

# After 8 days:
print(tv.state)          # TemporalState.GRACE
print(tv.decay_factor)   # 0.5-1.0 (degraded)

# Refresh
tv.refresh()  # resets the window
print(tv.state)  # TemporalState.VALID again
```

## Lifecycle

```
VALID (1.0x score) → GRACE (0.5-1.0x decay) → EXPIRED (0.0x)
        ↑                                         
    refresh() ← max 3 extensions
```

Zero external dependencies. Compatible with Python 3.8+.

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