Metadata-Version: 2.4
Name: plato-tile-search
Version: 0.1.0
Summary: Nearest-neighbor tile search — keyword overlap, domain matching, composite ranking
Author-email: SuperInstance Fleet <fleet@cocapn.ai>
License: MIT
Project-URL: Homepage, https://github.com/SuperInstance/plato-tile-search
Project-URL: Repository, https://github.com/SuperInstance/plato-tile-search
Keywords: plato,tiles,search,nearest-neighbor,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-search

Nearest-neighbor tile search — keyword overlap, domain matching, composite ranking.

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

## Installation

```bash
pip install plato-tile-search
```

## Usage

```python
from plato_tile_search import TileSearcher

searcher = TileSearcher(tiles=[
    {"content": "Pythagorean triples snap to exact coordinates", "domain": "constraint-theory"},
    {"content": "Deadband Protocol enforces P0 before P1 before P2", "domain": "governance"},
])

results = searcher.search("pythagorean snapping")
for r in results:
    print(f"[{r.match_type}] {r.score:.2f}: {r.tile['content'][:50]}")
```

## Match Types

| Type | Score | Description |
|------|-------|-------------|
| Exact | 1.0 | Full content match |
| Keyword | Jaccard | Token-level overlap |
| Domain | 0.3 | Same domain as query |
| Fuzzy | 0-0.5 | Substring and bigram overlap |

Zero external dependencies. Compatible with Python 3.8+.

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