Metadata-Version: 2.4
Name: metaspn-store
Version: 0.1.0
Summary: Minimal append-only durability layer and replay API for MetaSPN signals and emissions
Author: MetaSPN
License-Expression: MIT
Project-URL: Homepage, https://github.com/MetaSPN/metaspn-store
Project-URL: Repository, https://github.com/MetaSPN/metaspn-store
Project-URL: Issues, https://github.com/MetaSPN/metaspn-store/issues
Keywords: metaspn,event-store,replay,append-only,jsonl
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: metaspn-schemas>=0.1.0
Provides-Extra: dev
Requires-Dist: pytest>=8; extra == "dev"
Requires-Dist: build>=1.2.0; extra == "dev"
Requires-Dist: twine>=5.0.0; extra == "dev"
Requires-Dist: wheel>=0.43.0; extra == "dev"
Dynamic: license-file

# metaspn-store

`metaspn-store` provides a minimal append-only event store for MetaSPN signals and emissions.

## Features
- Filesystem JSONL backend (partitioned by UTC date)
- Append-only writes for signals and emissions
- Snapshot writes for deterministic state rebuild checkpoints
- Streaming replay by time window, entity reference, and source

## Layout
```text
workspace/
  store/
    signals/
      2026-02-05.jsonl
    emissions/
      2026-02-05.jsonl
    snapshots/
      system_state__2026-02-05T120000Z.json
```

## Release
```bash
python -m pip install -e ".[dev]"
pytest -q
python -m build
python -m twine check dist/*
python -m twine upload dist/*
```
