Metadata-Version: 2.4
Name: plato-tile-scorer
Version: 0.1.0
Summary: Multi-signal tile scoring — keyword, belief, domain, temporal, ghost, frequency, controversy
Author-email: SuperInstance Fleet <fleet@cocapn.ai>
License: MIT
Project-URL: Homepage, https://github.com/SuperInstance/plato-tile-scorer
Project-URL: Repository, https://github.com/SuperInstance/plato-tile-scorer
Keywords: plato,tiles,scoring,ranking,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-tile-scorer

Multi-signal tile scoring — keyword, belief, domain, temporal, ghost, frequency, controversy.

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

## Installation

```bash
pip install plato-tile-scorer
```

## Usage

```python
from plato_tile_scorer import TileScorer

scorer = TileScorer()

result = scorer.score(
    tile={
        "content": "Pythagorean triples snap to exact coordinates with zero drift",
        "confidence": 0.9,
        "domain": "constraint-theory",
        "priority": "P0",
    },
    query="pythagorean snapping",
)

print(result.score)    # weighted sum + deadband boost
print(result.signals)  # {"keyword": 0.33, "belief": 0.9, ...}
print(result.gated)    # False (keyword overlap > 0.01)
```

## 7 Scoring Signals

| Signal | Weight | Description |
|--------|--------|-------------|
| keyword | 0.30 | Token-level Jaccard overlap with query |
| belief | 0.25 | Confidence/belief score of tile |
| domain | 0.20 | Domain match with query context |
| temporal | 0.15 | Age-based freshness decay |
| ghost | 0.15 | Resurrection survival bonus |
| frequency | 0.10 | Usage count scaling |
| controversy | 0.10 | Counterpoint survival rate |

Keyword gating: if overlap < 0.01, score drops to 0. Deadband boost: P0 +10, P1 +1.

Zero external dependencies. Compatible with Python 3.8+.

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