plato-temporal-validity 0.1.0

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

plato-temporal-validity

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

Part of the PLATO framework — deterministic AI knowledge management through tile-based architecture.

Installation

pip install plato-temporal-validity

Usage

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