Metadata-Version: 2.4
Name: kuzu-grid-schema
Version: 0.1.0
Summary: Shared Kuzu grid tier schemas, composed DDL, and per-tier Cypher CRUD
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: kuzu>=0.7.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"

# kuzu-grid-schema

Pip-installable library that **owns** the Kuzu grid working-graph schema:

- Tier 0–3 JSON contracts
- One composed DDL for a **single** shared database
- Per-tier Cypher CRUD (write statements never cross tier ownership)
- `effective_*` refresh (`base → latest_actual → scenario → effective`)

```bash
pip install -e .
```

```python
from kuzu_grid_schema import apply_schema, open_database, refresh_effective
from kuzu_grid_schema.cypher import tier0, tier1, tier2, tier3

db, conn = open_database(":memory:")
apply_schema(conn)
```

Other packages (including `kuzu-mcp`) should depend on this library via pip — do not copy DDL.
